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Preface 


This manual is the Programmer’s Reference Manual for as — the assembler for 
Sun-2 and Sun-3 workstations running the SunOS operating system, as converts 
source programs written in assembly language into a form that the linker utility, 
/d(l) wDl turn into a rurmable program. 

as provides assembly language programmers with a minimal set of facilities to 
write programs in assembly language. Since most programming is done in high- 
level languages, as doesn’t provide any elaborate macro facilities or conditional 
assembly features. It is assumed that the volume of assembly code produced is 
so small that these facilities aren’t required. If they are needed, you can use the 
C preprocessor (see cpp(l)) to provide them. 

This manual describes the syntax and usage of the as assembler for the Motorola 
MC68010 and MC68020 microprocessors, the MC68881 floating-point coproces¬ 
sor, and Sun’s Floating-Point Accelerator (FPA). The basic format of as is 
loosely based on the Digital Equipment Corporation’s Macro-11 assembler 
described in DEC’S publication DEC-11-OMACA-A-D. It also contains elements 
of the UNIXt PDP-11 as assembler. The instruction mnemonics and effective 
address format are based on a Motorola publication on the MC68000: the 
MACSS MC68000 Design Specification Instruction Set Processor dated June 30, 
1979. 

This is a r^erence manual as opposed to a treatise on writing in assembly 
language. It assumes that you are familiar with the concepts of machine architec¬ 
ture, the reasons for an assembler, the ideas of instruction mnemonics, operands, 
and effective address modes, and assembler directives. It also assumes that you 
are familiar with the relevant processors, their instruction sets and addressing 
modes, and especially their irregularities. 

Motorola MC68010 16-bit Microprocessor Programmer’s Reference Manual. 
Motorola MC68020 32-bit Microprocessor User’s Manual. 

Motorola MC68881 Floating-Point Coprocessor User’s Manual. 


t UNDC is a registered trademaik of AT&T. 
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Introduction 


1.1. Using the Assembler By convention, the assembly language source code of the program should be in 

one or more files with a . s suffix. Suppose that your program is in two files 
called parts . s and rest. s. To run the assembler, type the command: 


r 

tutorial% as parts.s rest.s 

as runs silently (if there are no errors), and generates a file called a. out. 

as also accepts several command-line options. These are: 

—ofile 

Place the output of the assembler in file instead of a.out. 

-m68010 

This is the default on Sun-2 systems. Accept only the MC68010 
instruction set and addressing modes. This also puts the MC68010 
machine type tag into the a.out file. 

-m68020 

This is the default on Sun-3 systems. Accept the full MC68020, 
MC68881, and Sun FPA instmction sets and addressing modes. 
Includes the MC68010 instruction set and addressing modes as a 
subset, and also puts the MC68020 machine type tag into the a.out 
file. 

-k 

Generate position-independent code as required by 


cc -pic/-PIC 

j 


WARNING Don’t apply this flag to hand-coded assembler programs unless they are written 

to be position-independent 


-O Perform span-dependent instruction resolution over each entire file, 

rather than just over each procedure (see the description of the proc 
pseudo-operation in Chapter 5). 

-R Make initialized data segments read-only (actually the assembler 

places them at the end of the . text area). 

-L Keep local (compiler-generated) symbols that start with the letter L. 

This is a debugging feature. If the -L option is omitted, the assem¬ 
bler discards those symbols and does not include them in the symbol 
table. 
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1.2. Notation 


-j 


-J 


Make all jumps to external symbols ( j sr and jmp) 

PC-relative rather than long-absolute. This is intended for use when 
the programmer knows that the program is short, since it only per¬ 
mits jumps (forward or back) up to 32K bytes long. If there are any 
externals which are too far away, the loader wiU complain when the 
program is linked. 



Suppress span-dependent instruction calculations and force aU 
branches and calls to take the most general form. This is used when 
assembly time must be minimized, but program size and run time 
are not important. 


-h Suppress span-dependent instruction calculations and force aU 

branches to be of medium length, but aU calls to take the most gen¬ 
eral form. This is used when assembly time must be minimized, but 
program size and running time are not important. This option results 
in a smaller and faster program than that produced by the - J option, 
but some very large programs may not be able to use it because of 
the limits of the medium-length branches. 

-d2 This is intended for small stand-alone programs. The assembler 
makes aU program references PC-relative and aU data references 
short-absolute. Note that the - j option does half this job. 

You should also consult the SunOS Reference Manual entry on a s. 

V.. •''' 

The notation used in this manual is a somewhat modified Backus-Naur Form 

(BNF). A string of characters on its own stands for itself, for example: 

- 

WIDGET 

s__ 

is an occurrence of the literal string ‘widget’, and: 

- 

1983 

^^ 


is an occurrence of the literal constant 1983. An element enclosed in < and > 
signs is a non-terminal symbol, and must eventually be defined in terms of some 
other entities. For example, 

( - \ 

<identifier> 

^/ 

stands for the syntactic construct called ‘identifier’, which is eventually defined 
in terms of basic objects. A syntactic object followed by an ellipsis: 

-s 

<thing> . . . 

V_/ 


denotes one or more occurrences of <thing>. 
Syntactic objects occurring one after the other, as in: 
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r ' 

<first thing > <second thing > 

^ _ ; ___ 

simply means an occurrence of^m thing followed by second thing. Syntactic 
elements separated by a vertical bar sign (I), as in; 


r 

-\ 

<letter> \ <digit> 


V_]_ 

J 


mean an occurrence of <letter> or <digit> but not both. Brackets and braces 
define the order of interpretation. Brackets also indicate that the syntax 

described by the subexpression they enclose is optional. That is: 
-- 

[ <thing> ] 

s___/ 

denotes zero or one occurrences of <thing>, while { and } are used for grouping 
so that 

-- 

{ <thing one> \ <thing two> } <thing three> 

> _ / 

denotes a <thing one> or a <thing two, followed by a <thing three>. 



sun 

microsystems 
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Elements of Assembly Language 


This chapter covers the lexical elements which comprise an assembly language 
program. (Chapter 3 discusses the rules for expression and operand formation.) 
Topics covered in this chapter are: 

□ The character set that the assembler recognizes, 

□ Rules for identifiers and labels, 

□ Syntax for numeric constants, 

□ Syntax for string constants, 

o The assembly location counter. 

An assembly language program is ultimately constructed from characters. Char¬ 
acters are combined to make up lexical elements or tokens of the language. Com¬ 
binations of tokens form assembly language statements, and sequences of state¬ 
ments form an assembly language program. This section describes the basic lexi¬ 
cal elements of as. 

2.1. Character Set as recognizes the following character set: 

□ The A through Z and a through z. 

□ The digits 0 through 9. 

o The ASCII graphic characters — the printing characters other than letters 
and digits. 

□ The ASCII non-graphics: space, tab, carriage return, and newline (also 
known as linefeed). 

2.2. Identifiers Identifiers are used to tag assembler statements (where they are called labels), as 

location tags for data, and as the symbolic names of constants. 

An identifier in an as program is a sequence of from 1 to 255 characters from the 
set: 

□ Upper case letters A through z. 

□ Lower case letters a through z. 

□ Digits 0 through 9. 
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□ The characters underline (_), period ( . ), and dollar sign ( $). 

The first character of an identifier must not be numeric. Other than that restric¬ 
tion, there are a few other points to note: 

□ All characters of an identifier are significant and are checked in comparisons 
with other identifiers. 

□ Upper case letters and lower case letters are distinct, so that 
kit_of_part s and KlT_OF_PARTS are two different identifiers. 

□ Although the period (.) and dollar sign ($) characters can be used to con- 
stmct identifiers, they are reserved for special purposes (pseudo-ops for 
instance) and should not appear in user-defined identifiers. 


Here are some examples of legal identifiers: 



Grab Hold 



Widget 

Pot_of_Message 

MAXNAME 


V_ 


J 


2.3. Numeric Labels A numeric label consists of a digit (0 to 9) followed by a colon. As in the case of 

alphanumeric labels, a numeric label assigns the current value of the location 
counter to the symbol. However, several numeric labels with the same digit may 
be used within the same assembly. References of the form nb refer to the first 
numeric label named n backwards from the reference; n f symbols refer to the 
first numeric label named n/orwards from the reference. 

2.4. Local Labels Local labels are a special form of identifier which are strictly local to a control 

section (see Section 5.4). Local labels provide a convenient means of generating 
labels for branch instructions arid such. Use of local labels reduces the possibil¬ 
ity of multiply defined labels in a program, and separates entry point labels from 
local references, such as the top of a loop. Local labels cannot be referenced 
from outside the current assembly unit. Local labels are of the form n$ where n 
is any integer. Valid local labels include: 



1$ 



27$ 



394$ 


V_ 


J 


2.5. Scope of Labels The scope of a label is the ‘distance’ over which it is visible to other parts of the 

program which may reference it. An ordinary label which tags a location in the 
program or data is visible only within the current assembly. An identifier which 
is designated as an external identifier via a . globl directive is visible to other 
assembly units at link time. 

Local labels have a scope, or span of reference, which extends between one ordi¬ 
nary label and the next. Every time an ordinary label is encountered, aU previous 
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local labels associated with the current location counter are discarded, and a new 
local label scope is created. The following example illustrates the scopes of the 
different kinds of labels: 


first: 

addl 

d0,dl 

1 creates a 

new local label scope 


100$: 

addqw 

bees 

#7,d3 

100$ 

1 first appearance of 100$ 

1 branches to the label above 


second: 

andl 

#0x7ff,d4 

1 above 100$ has gone away 


100$: 

empw 

beqs 

dl,d3 

100$ 

1 this is a 
1 branches 

different 100$ 
to the previous instruction 


third: 

movw 

beqs 

d0,d7 

100$ 

1 now 100$ 

1 generates 

has gone away again 
an error message if no 100$ below 



The labels first, second, and third all have a scope which is the entire 
source file containing them. The first appearance of the local label 10 0 $ has a 
scope which extends between first and second. 

The second appearance of the local label 10 0 $ has a scope which extends 
between second and third. After the appearance of the label third, the 
branch to 10 0 $ will generate an error message because that label is no longer 
defined in this scope. 

2.6. Constants There are two forms of constants available to as users, namely numeric con¬ 

stants Mid string constants. AH constants are considered absolute quantities 
when they appear in an expression (see Section 3.4 for a discussion on absolute 
and relocatable expressions). 

2.7. Numeric Constants as assumes that any token which starts with a digit is a numeric constant, as 

accepts numeric quantities in decimal (base 10), hexadecimal (base 16), or octal 
(base 8) radices. Numeric constants can represent quantities up to 32 bits in 
length. 

Decimal numbers consist of between one and ten decimal digits (in the range 0 
through 9). The range of decimal numbers is between -2,147,483,648 and 
2,147,483,647. Note that you can’t have commas in decimal numbers even 
though they are shown here for readability. Note also that decimal numbers can’t 
be written with leading zeros, because a numeric constant starting with a zero is 
taken as either an octal constant or a hexadecimal constant, as described below. 

Hexadecimal constants start with the notation Ox or OX (zero-ex) and can then 
have between one and eight hexadecimal digits. The hexadecimal digits consist 
of the decimal digits 0 through 9 and the hexadecimal digits a through f or 
A through F. 

Octal constants start with the digit 0. There can then be from one to 11 octal 
digits (0 through 7) in the number. But note that 11 octal digits is 33 bits, so the 
largest octal number is 037777777777. 


microsystems 


Revision A of May 9, 1988 










12 Assembly Language Reference 


O; 

Floating-point constants must start with #0r or #0R, which may be followed by 
an optional sign and either a number, an infinity or a nan ("not a number"). The 
syntax is 

( -^ 

{#0r I #0R} [+ I -] {<number> \ inf | nan} 

k_/ 


where the syntax of a <number> is 

/ - ^\ 

{<digits> [. [<di 5 to>] ] I . <digits>} [E [+ | -] <digits>'i 
V_ 

and <digits> is a string of decimal digits. 

2.8. String Constants A string is a sequence of ASCII characters, enclosed in quote signs 

Within string constants, the quote sign is represented by a backslash character 
followed by a quote sign. The backslash character itself is represented by two 
backslash characters. Any other character can be represented by a backslash 
character followed by one, two, or three octal digits, or by a backslash followed 
by Ox or OX and a one- or two-digit hexadecimal constant. The table below 
shows the octal representation of some of the more common non-printing charac- 



Character 

Octal 

Hex 

Backspace 

\010 

0x8 

Horizontal Tab 

\011 

0x9 

Newline (Linefeed) 

\012 

OxA 

Formfeed 

\014 

OxC 

Carriage Return 

\015 

OxD 


2.9. Assembly Location The assembly location counter is the period character (.). It is colloquially 

Counter known as dot. When used in the operand field of any statement, dot represents 

the address of the first byte of the statement. Even in assembler directives, dot 
represents the address of the start of that assembler directive. For example, if dot 
appears as the third argument in a . long directive, the value placed at that loca¬ 
tion is the address of the first location of the directive — dot is not updated imtil 
the next machine instruction or assembler directive. For example: 


Ralph: movl .,a0 I load value of Ralph into aO 


o 
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You can reserve storage by advancing dot. 
For example, the statement 


f - 



Table: 

.=.+0x100 


V_ 


J 


reserves 256 bytes (100 hexadecimal) of storage, with the address of the first byte 
as the value of Table. This is exactly equivalent to using . skip (the preferred 
syntax) as follows: 

Table: .skip 0x100 

^____ 


The value of dot is always relative to the start of the current control section. For 
example, 

-^ ^ . 

. = 0x1000 

V_ 

doesn’t set dot to absolute location 0x1000, but to location 0x1000 relative to the 
start of the current control section. This practice is not recommended. 



micros^t^s 
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3 


Expressions 


Expressions are combinations of operands (numeric constants and identifiers) and 
operators, forming new values. The sections below define the operators which 
as provides, then gives the rules for combining terms into expressions. 

3.1. Operators Identifiers and numeric constants can be combined, via arithmetic operators, to 

form expressions, as provides unary operators and binary operators, as 
described below. 

Table 3-1 Unary Operators in Expressions 


Operator 

Function 

Description 

- 

unary minus 

Two’s complement of its argument. 


logical negation 

One’s complement (logical negation) of its argu¬ 
ment. 



Table 3-2 Binary Operators in Expressions 


Operator 

Function 

Description 

+ 

addition 

Arithmetic addition of its arguments. 

- 

subtraction 

Arithmetic subtraction of its arguments. 

* 

multiplication 

Arithmetic multiplication of its arguments. 

/ 

division 

Arithmetic division of its arguments. Note that 
division in as is integer division, which trun¬ 
cates towards zero. 


Each operator works on 32-bit numbers. If the value of a particular term occu¬ 
pies only 8 bits or 16 bits, it is sign extended to a full 32-bit value. 



17 
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3.2. Terms A term is a component of an expression. A term may be any of the following: 

□ A numeric constant, whose 32-bit value is used. The assembly location 
cotmter, known as dot, is considered a number in this context 

□ An identifier. 

□ An expression or terra enclosed in parentheses ( ). 

Any quantity enclosed in parentheses is evaluated before the rest of the 
expression. This can be used to alter the normal left-to-right evaluation of 
expressions — for example, differentiating between a*b+c and a* (b+c} 
or to apply a tmary operator to an entire expression — for example, 

-(a*b+c). 

□ A term preceded by a unary operator. For example, both 
double_plus_ungood and ~double_plus_ungood are terms. 

Multiple unary operators can be used in a term. For example,-positive 

has the same value as posit ive. 

3.3. Expressions Expression are combinations of terms joined together by binary operators. An 

expression is always evaluated to a 32-bit value. 

If the operand requires only a single-byte value (a . byte directive or an addq 

instruction, for example) the low-order eight bits of the expression are used. 

If the operand requires only a 16-bit value (a .word directive or a movem 

instruction, for example) the low-order 16 bits of the expression are used. 


Expressions are evaluated left to right with no operator precedence. Thus 


r - 

•N 

1 + 2*3 



J 


evaluates to 9, not 7. Unary operators have precedence over binary operators 
since they are considered part of a term, and both terms of a binary operator must 
be evaluated before the binary operator can be applied. 

A missing expression or term is interpreted as having a value of zero. In this 
case, an Invalid expression error is generated. 

An Invalid Operator error means that a valid end-of-line character or binary 
operator was not detected after the assembler processed a term. In particular, this 
error is generated if an expression contains an identifier with an illegal character, 
or if an incorrect comment character was used. 


3.4. Absolute, Relocatable, 
and External 
Expressions 


When an expression is evaluated, its value is either absolute, relocatable, or 
external: 

An expression is absolute if its value is fixed. 

o An expression whose terms are constants is absolute. 

a An identifier whose value is a constant via a direct assignment statement is 
absolute. 
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□ A relocatable expression minus a relocatable term is absolute, if both items 
belong to the same program section. 

An expression is relocatable if its value is fixed relative to a base address, but 
wiU have an offset value when it is linked or loaded into memory. All labels of a 
program defined in relocatable sections are relocatable terms. 

Expressions which contain relocatable terms must only add or subtract constants 
to their value. For example, assuming the identifiers widget and blivet 
were defined in a relocatable section of the program, then the following demon¬ 
strates the use of relocatable expressions: 


Expression 

Description 

widget 

is a simple relocatable term. Its value is an offset from 
the base address of the current control section. 

widget+5 

is a simple relocatable expression. Since the value of 
widget is an offset from the base address of the current 
control section, adding a constant to it does not change 
its relocatable status. 

widget*2 

Not relocatable. Multiplying a relocatable term by a 
constant invalidates the relocatable status. 

2—widget 

Not relocatable, since the expression carmot be linked by 
adding widget ’s offset to it. 

widget—blivet 

Absolute, since the offsets added to widget and 
blivet cancel each other out. 


An expression is external (or global) if it contains an external identifier not 
defined in the current program. With one exception, the same restrictions on 
expressions containing relocatable identifiers apply to expressions containing 
external identifiers. The exception is that the expression 


f - 


widget—blivet 


V 

J 


is incorrect when both widget and blivet are external identifiers — you 
cannot subtract two external relocatable expressions. In addition, you carmot 
multiply or divide any relocatable expression. 
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Assembly Language Program Layout 


An as program consists of a series of statements. Several statements can be 
written on one line, but statements cannot cross line boundaries. The format of a 
statement is: 



It is possible to have a statement which consists of only a label field. 


The fields of a statement can be separated by spaces or tabs. There must be at 
least one space or tab separating the opcode field from the operand field, but 
spaces are unnecessary elsewhere. Spaces may appear in the operand field. 
Spaces and tabs are significant when they appear in a character string (for 
instance, as the operand of an .ascii pseudo-op) or in a character constant. In 
these cases, a space or tab stands for itself. 

A line is a sequence of zero or more statements, optionally followed by a com¬ 
ment, ending with a < newlino character. A line can be up to 4096 characters 
long. Multiple statements on a line are separated by semicolons. Blank lines are 
allowed. The form of a line is: 



Labels are identifiers which the programmer may use to tag the locations of pro¬ 
gram and data objects. The format of a <label field> is: 



If present, a label always occurs first in a statement and must be terminated by a 
colon: 



23 
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More than one label may appear in the same source statement, each one being 
terminated by a colon: 


/ 



presson: grab: hold: 

1 multiple labels defined here. 


V__:_ 


J 


The coUection^of label definitions in a statement is called the label field. 

When a label is encountered in the program, the assembler assigns that label the 
value of the current location counter. The value of a label is relocatable. The 
symbol’s absolute value is assigned when the program is hnked with the system 
linker ld{\). 

4.2. Operation Code Field The operation code field of an assembly language statement identifies the state¬ 
ment as either a machine instruction or an assembler directive. 

One or more spaces (or tabs) must separate the operation code field from the fol¬ 
lowing operand field in a statement. Spaces or tabs are unnecessary between the 
label and operation code fields, but they are recommended to improve readability 
of the program. 

A machine instruction is indicated by an instruction mnemonic. The assembly 
language statement is intended to produce a single executable machine instruc¬ 
tion. The operation of each instruction is described in the manufacturer’s user 
manual. Conventions used in as for instruction mnemonics are described in 
Chapter 6 and a complete list of the instructions is presented in Appendix B. 

An assembler directive, or pseudo-op, performs some function during the assem¬ 
bly process. It does not produce any executable code, but it may assign space for 
data in a program. 

Note that as expects that aU instruction mnemonics in the op-code field should 
be in lower case only. Using upper case letters in instruction mnemonics gives 
rise to an error message. 

The names of register operands must also be in lower case only. This behavior 
differs from the case of identifiers, where both upper and lower case letters may 
be used and are considered distinct. 

Many MC68010 and MC68020 machine instructions can operate upon byte (8- 
bit), word (16-bit), or long word (32-bit) data. The size which the programmer 
requires is indicated as part of the instruction mnemonic. For instance, a movb 
instruction moves a byte of data, a movw instruction moves a 16-bit word of data, 
and a movl instruction moves a 32-bit long word of data. In general, the default 
size for data manipulation instructions is word. 

Many MC68881 machine instructions can operate on byte, word or long word 
integer data, on single-precision (32-bit), double-precision (64-bit) or extended- 
precision (96-bit) floating-point data or on packed-decimal (96-bit) data. The 
size required is specified as part of the instruction mnemonic by a trailing "b", 
"w", "1", "s", "d", "x" orp, respectively. 

An alternate coprocessor id can be specified for MC68881 instructions by 
appending @id to the opcode, such as f add@2. If you don’t do this, the 
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4.3. Operand Field 




coprocessor id specified by the most recent . cpid pseudo-operation is used. 
(See Chapters.) 

Similarly, branch instructions can use a long or short offset specifier to indicate 
the destination. So the beq instruction uses a 16-bit offset, whereas the beqs 
uses a short (8-bit) offset. 

Note that this implementation of as provides an extended set of branch instmc- 
tions which start with the letter j instead of the letter b. If the programmer uses 
the j forms, the assembler computes the offset size for the instraction. See Sec¬ 
tion 1.1 for the assembler options which control this. 


The operand field of an assembly language statement supplies the arguments to 
the machine instmction or assembler directive. 


as makes a distinction between the <operandfield> and individual <operands> 
in a machine instruction or assembler directive. Some machine instructions and 
assembler directives require two or more arguments, and each of these is referred 
to as an “operand”. 

In general, an operand field consists of zero or more operands, and in all cases, 
operands are separated by conunas. In other words, the format of an <operand 
field> is: 

( -- -^ 

[ <operand> [ , <operand> ] . . . ] 

V.....> 

The general format of the operand field for machine instructions is the same for 
all instructions, and is described in Chapter 6. The format of the operand field 
for assembler directives depends on the directive itself, and is included in the 
directive’s description in Chapter 5 of this manual. 

Depending upon the machine instruction or assembler directive, the operand field 
consists of one or more operands. The kinds of objects which can form an 
operand are: 


□ Register operands 

□ Register pairs 

□ Address Operands 

□ String constants 

□ Floating-point constants 

D Register lists 

□ Expressions 

Register operands in a machine instruction refer to the machine registers of the 
processor or coprocessor. 

Note that register names must be in lower case; as does not recognize register 
names in upper case or a combination of upper case and lower case. 
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Expressions are described in Chapter 3, address operands in Section 6.3, and con- y 
stants in Chapter 2. 

4.4. Comment Field as provides the means for the programmer to place comments in the source 

code. There are two ways of representing comments. 

A line whose first non-whitespace character is the hash character (#) is con¬ 
sidered a comment. This feature is handy for passing C preprocessor output 
through the assembler. For example, these lines are comments: 

- —— - ' 

# This is a comment line. 

# And this one is also a comment line. 

V___ 

Vae, other way to introduce a comment is when a comment field appears on a line 
with a statement. The comment field is indicated by the presence of the vertical 
bar character (|) after the source statement. 

The comment field consists of all characters on a source line following and 
including the comment character. The assembler ignores the comment field. 

Any character may appear in the comment field, with the obvious exception of 
the <newUne> character, which starts a new line. 




An assembly language source line can consist of just a comment field. For exam¬ 
ple, the two statements below are quite acceptable to the assembler: 


r 

A 

1 This is a comment field. 


1 So is this. 


^ . _ __ 

J 


4.5. Direct Assignment 
Statements 


A direct assignment statement assigns the value of an arbitrary expression to a 
specified identifier. The format of a direct assignment statement is: 




<identifier> = 

<expression> 

J 

Examples of direct assignments are: 



vect_size 

= 4 

vectors 

= OxFFFE 

vectorb 

= vectora-vect_size 

CRLF 

= OxODOA 

dtemp 

= dO 1 use register dO as temporary 


J 


Any identifier defined by direct assignment may be redefined later in the pro¬ 
gram, in which case its value is the result of the last such statement. This is 
analogous to the SET operation foimd in other assemblers. 


A local identifier may be defined by direct assignment, though this doesn’t make 
much sense. 
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Register identifiers may not be redefined. 

An identifier which has already been used as a label may not be redefined, since 
this would be tantamount to redefining the address of a place in the program, hi 
addition, an identifier which has been defined in a direct assignment statement 
cannot later be used as a label. Both situations give rise to assembler error mes¬ 
sages. 

If the <expression> in a direct assignment is absolute, the identifier is also abso¬ 
lute, and may be treated as a constant in subsequent expressions. If the <expres- 
sion> is relocatable, however, the < identifier > is also relocatable, and it is con¬ 
sidered to be declared in the same program section as the expression. 


If the <expression> contains an external identifier, the identifier defined by direct 
assignment is also considered external. For example: 


- 


s 

.globl X 

1 X is declared as external identifier 


holder = X 

1 holder becomes an external identifier 


V 


_ / 


assigns the value of x (zero if it is undefined) to holder and makes holder an 
external identifier. External identifiers may be defined by direct assignment. 
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Assembler Directives 


Assembler directives are also known as pseudo operations or pseudo-ops. 
Pseudo-ops are used to direct the actions of the assembler, and to achieve effects 
such as generating data. The pseudo-ops available in as are listed in Table 5-1 
below. 

Table 5-1 Assembler Directives 


Pseudo- 

Operation 

Description 

.ascii 

Generates a sequence of ASCn characters. 

. asciz. 

Generates a sequence of ASCII characters, terminated by a zero byte. 

.byte 

Generates a sequence of bytes in data storage. 

.bytez 

Generates a sequence of bytes in data storage initialized to zero. 

. word 

Generates a sequence of words in data storage. 

. long 

Generates a sequence of long words in data storage. 

.single 

Generates a sequence of single-precision floating-point constants in 
data storage. 

.double 

Generates a sequence of double-precision floating-point constants in 
data storage. 

. text 

Specifies that generated code be placed in the text control section until 
further notice. 

. data 

Specifies that generated code be placed in the data control section until 
further notice. 

.datal 

Specifies that generated code be placed in the datal control section 
until further notice. 

.data2 

Specifies that generated code be placed in the datal control section 
until further notice. 

.bss 

Specifies that space will be reserved in the bss control section until 
further notice. 

.globl 

Declares an identifier as global (external). 

. comm 

Declares the name and size of a common area. 
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Table 5-1 

Assembler Directives — Continued 


Pseudo- 

Operation 

Description 


. Icoiran 

Reserves a specified amount of space in the bss control section. 


.skip 

Advances the location counter by a specified amount. 


. align 

. even 

Forces location counter to next one-, two- or four-b 5 ^e boundary. 

Forces location counter to next word (even-byte) boundary. 


.stabx 

Builds special symbol table entries. These directives are included for 
the benefit of compilers which generate information for the symbolic 
debuggers dbx and dbxtool. 


.proc 

Separates procedures for faster span-dependent instruction resolution. 


. cpid 

Assigns a coprocessor number. 

These assembler directives are discussed in detail in the following sections. 

5.1. . ascii — Generate 
Character Data 

The .ascii directive translates character strings into their ASCII equivalents 
for use in the source program. The format of the . ascii directive is: 


f 

[ <label>: 

\ _ 

] .ascii" " <character string >" 


<character string> contains any character or escape sequence which can appear 
in a character string. Obviously, a newline must not appear within the character 
string. A newline can be represented by the escape sequence N012. The following 
examples illustrate the use of the . ascii directive: 


c 








--- 


Octal Code Generated: 



Statement: 


150 

145 

154 

154 

157 

040 

.ascii 

"hello there" 


164 

150 

145 

162 

145 





127 

141 

162 

156 

151 

156 

,ascii 

"Warning—\007\007 \012" 


147 

055 

007 

007 

040 

012 




141 

142 

143 

144 

145 

146 

,ascii 

"abcdefg" 


147 

















J 
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5.2. . asciz — Generate 
Zero-Terminated 
Sequence of Character 
Data 


The .asciz directive is equivalent to the .ascii directive except that a zero 
byte is automatically inserted as the final character of the string. This feature is 
intended for generating strings which C programs can use. The following exam¬ 
ples illustrate the use of the .asciz directive: 


( - 










Octal Code Generated: 


j Statement: 



110 

145 

154 

154 

157 

040 

.asciz "Hello World!" 



127 

157 

162 

144 

041 

000 




124 

150 

105 

040 

107 

162 

.asciz "The Great PROMpkin strikes again!" 



145 

141 

164 

040 

120 

122 




117 

115 

160 

153 

151 

156 




040 

163 

164 

162 

151 

153 




145 

163 

040 

141 

147 

141 




151 

156 

041 

000 














J 


5.3. Directives to Generate 
Data 


The .byte, .word, .long, . single, and . double directives reserve 
storage locations and initialize them with specified values.-. 

The format of the various forms of data generation statements are: 


[ 

<label >: ] 

.byte 

[ <expression> 

] 

[ 

, <expression> 

]... 

[ 

<label >: ] 

.bytez 

[ <expression> 

] 

[ 

, <expression> 

] . . . 

[ 

<label>: ] 

.word 

[ <expression> 

] 

[ 

, <expression> 

] . . . 

[ 

<label >: ] 

. long 

[ <expression> 

] 

[ 

, <expression> 

] . . . 

[ 

<label >: ] 

. single 

[ <expression> 

] 

[ 

, <expression> 

] . . . 

[ 

<label >: ] 

.double 

[ <expression> 

] 

[ 

, <expression> 

] . . . 

V 







_^ 


The . byte directive reserves one byte (8 bits) for each expression in the 
operand field, and initializes it to the low-order 8 bits of the corresponding 
expression. 

The . bytez directive reserves one byte (8 bits) for each expression in the 
operand field, and iititializes it to zero. 

The . word directive reserves one word (16 bits) for each expression in the 
operand field, and initializes it to the low-order 16 bits of the corresponding 
expression. 

The .long directive reserves one long word (32 bits) for each expression in the 
operand field, and initializes it to the value of the corresponding expression. 
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5.4. Directives to Switch 
Location Counter 


The . single directive reserves one long word for each expression in the 
operand field, and initializes it to the low-order 32 bits of the corresponding 
expression. 

The . double directive reserves a pair of long words for each expression in the 
operand field, and initializes them to the value of the corresponding expression. 

Multiple expressions can appear in the operand field of the . byte, . word, 

. long, . single, and . double directives. Multiple expressions must be 
separated by commas. 



These statements .text, .data, .bss, .datal, and .data2, change the 
‘control section’ where assembled code is loaded. 

as (and the system linker) view programs as divided into three distinct sections 
or address spaces: 


Space 

Description 

text 

The address space where the executable machine instructions are 
placed. 

data 

The address space where initialized data is placed. The assem¬ 
bler actually knows about three data areas, namely, data, datal, 
and data2. The second and third data areas are mainly for the 
benefit of compilers and are of minimal interest to the assembly 
language programmer. 

If the -R option is coded on the as command line, it means that 
the initialized data should be considered read-only. It is actually 
placed at the end of the text area. 

bss 

The address space where the uninitialized data areas are placed. 
Also, see the . 1 conun directive described below. 



For historical reasons, the different areas are frequently referred to as ‘control 
sections’ (csects for short). 

These sections are equivalent as far as as is concerned, with the exception that 
no instructions or data are generated for the bss section — only its size is com¬ 
puted and its symbol values are output. 

During the first pass of the assembly, as maintains a separate location counter 
for each section. Consider the following code fragments: 



u mi 

Xr microsystems 
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f 

code: 

.text 

movw 

dl,d2 

1 place next instruction 

1 in text section 

\ 

grab: 

.data 
. long 

27 

1 now generate data in 

1 data section 


more: 

.text 

addw 

d2,dl 

1 now revert to text 

1 section 


hold: 

.data 

.byte 

4 

1 now back to data section 



During the first pass, as creates the intermediate output in two separate chunks: 
one for the text section and one for the data section. In the text section, code 
immediately precedes more; in the data section, grab immediately precedes 
hold. At the end of the first pass, as rearranges aU the addresses so that the 
sections are sent to the output file in the order: text, data and bss. 

The resulting output file is an executable image file with all addresses correctly 
resolved, with the exception of undefined . globl’s and . comm’s. 

For more information on the format of the assembler’s output file, consult the 
a.outiS) entry in the System Programmer’s Reference Manual. 

5.5. . skip — Advance the 
Location Counter 


where <size> is the number of bjdes by which the location coimter should be 
advanced. The .skip directive is equivalent to performing direct assignment 
on the location counter. For instance, a . skip directive like this: 

-V 

Table .skip 1000 

. _ ^ ^ 

reserves 1000 b)des of storage, with the value of Table equal to the address of the 
first byte. 


The . skip directive reserves storage by advancing the current location counter 
a specified amount. The format of the . skip directive is: 

[ <label >: ] . skip < size > 

\ _ 


5 . 6 . . 1 comm — Reserve 
Space in bss Area 


The . Icomm directive is a compact way to get a specific amount of space 

reserved in the bss area. The format of the . Icomm directive is: 
- 

.Icomm < name >,< size > 

S_L_' 

where <name> is the name of the area to reserve, and <size> is the number of 
bytes to reserve. The . Icomm directive specifically reserves the space in the bss 
area, regardless of which location counter is currently in effect. 
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A . Icomm directive like this: 


f -^- 

•Icomm lower_forty,1200 

j 

is equivalent to these directives: 


f 

.bss 1 switch to .bss area 

lower_forty: .skip size 

revert to previous control section 

\ 


j 


5.7. . g 1 ob 1 — Designate A program may be assembled in separate modules, and then linked together to 

an External Identifier form a single executable unit. See the ld{\) command in the SunOS Reference 

Manual. 

External identifiers are defined in each of these separate modules. An identifier 
which is defined (given a value) in one module may be referenced in another 
module by declaring it external in both modules. 

There are two forms of external identifiers, namely, those declared with the 
. globl and those declared with the . comm directive. The . comm directive is 
described in the next section. 

External symbols are declared with the . globl assembler directive. The format 
is: 

. globl <symbol> [ , <symbol> ] . . . 

s_/ 


For example, the following statements declare the array TABLE and the routine 
SRCH as external symbols, and then define them as locations in the current con¬ 
trol section: 


f - 

.globl 

TABLE, SRCH 

-\ 

TABLE: 

.word 

0,0,0,0,0 


SRCH: 

movw 

TABLE,dO 



etc. 



ii. 



J 


5.8. . comm — Define Name 
and Size of a Common 
Area 


The . comm directive declares the name and size of a common area, for compati¬ 
bility with FORTRAN and other languages which use common. The format of the 
. comm statement is: 

- 

.comm <name>, <constantexpression> 

V_. 


where <name> is the name of the common area, and <constantexpression> is 
the size of the common area. The . comm directive implicitly declares the 
identifier <name> as an external identifier. 
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5.9. .align — Force 
Location Counter to 
Particular Byte 
Boundary 


as does not allocate storage for common symbols; this task is left to the linker. 
The linker computes the maximum declared size of each common symbol (which 
may appear in several load modules), allocates storage for it in the final bss sec¬ 
tion, and resolves linkages. If, however, <name> appears as a global symbol 
(label) in any module of the program, aU references to <name> are linked to it, 
and no additional space is allocated in the bss area. 


The . align directive advances the location counter to the next one-, two- or 
four-byte boundary, if it is not currently on such a boundary. Intervening bytes 
are fiUed with zeros. The format of the . align directive is: 



where <size> must be an assembler expression which evaluates to 1,2 or 4. 

This directive is necessary because word and long word data values must lie on 
even-byte boundaries, because machine instructions must start on even-byte 
boundaries, and because the MC68020 is much more efficient if word and long 
word data are on even-byte and four-byte boundaries, respectively. 


5.10. .even —Force 

Location Counter to 
Even Byte Boundary 


The . even directive advances the location counter to the next even-byte boun¬ 
dary, if its current value is odd. This directive is necessary because word and 
long word data values must lie on even-byte boundaries, and also because 
machine instructions must start on even-byte boundaries. . even is equivalent 
to . align 2. 

. even 

^ _ / 


5.11. . St abx — Build 

Special Symbol Table 
Entry 


The . St abx directives are provided for the use of compilers which can generate 
information for the symbolic debuggers dbxmd dbxtool. The directives 
. stabs, . stabd, and . stabn build various types of symbol table entries. 

The .stab directives have the following forms: 



.stabs 

name, type, 0, desc, value 

\ 


.stabn 

type, 0, desc, value 


1 




or 


.stabd 

type, 0,desc 

-N 






msun 
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5.12. 


5.13. 


The . stabs directives are used to describe types, variables, procedures, and so 
on, while the . stabn directives convey information about scopes and the map¬ 
ping from source statements to object code. 

A . Stabd directive is identical in meaning to a corresponding . stabn direc¬ 
tive with the value field set to (dot), which the assembler uses to mean the 
current location. Most of the needed information, for example symbol name and 
type structure, is contained in the name field. The type field identifies the type of 
symbolic information, for example source file, global symbol, or source line. 

The desc field specifies the number of bytes occupied by a variable or type or the 
nesting level for a scope symbol. The value field specifies an address or an 
offset 


. pr oc — Separate 
Procedures for Span- 
Dependent 
Instruction 
Resolution 


The . proc directive separates procedures for span-dependent instruction resolu¬ 
tion. In its absence the assembler does span-dependent instruction resolution 
over entire files. If . proc is used, the resolution is done between occurrences of 
the directive and between either end of the file and its nearest occurrences. Since 
the algorithm used requires more than linear time, using . proc can save 
significant time for large assemblies. Branch instructions must not cross .proc 
directives, although calls may. 


/- 

N 

.proc 


V 

j 


. cpid — Name 
Default Coprocessor 


ID 


The . cpid directive gives the assembler a coprocessor id value to use for 
MC68881 instructions that don’t have an explicit coprocessor id given. The 
form of the directive is 


/ - 


.cpid < id > 





If no . cpid directive is given in a program, a value of 1 is assumed. Since no 
Sun systems currently have more than one coprocessor, you don’t need to use 
this directive. 
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Instructions and Addressing Modes 


This chapter describes the conventions used in as to specify instruction 
mnemonics and addressing modes. The information in this chapter is specific to 
the machine instmctions and addressing modes of the MC68010 and MC68020 
microprocessors and the MC68881 coprocessor. See Appendix C for informa¬ 
tion on the Sun FPA’s instructions set and addressing modes. 

6.1. Instruction Mnemonics The instmction mnemonics that as uses are based on the mnemonics described 

in the relevant Motorola processor manuals. However, as deviates from them in 
several areas. 

Most of the MC68010 and MC68020 instructions can apply to byte, word or long 
operands. Instead of using a qualifier of . b, . w, or . 1 to indicate byte, word, or 
long as in the Motorola assembler, as appends a suffix to the normal instmction 
mnemonic, thereby creating a separate mnemonic to indicate which length 
operand was intended. 

For example, there are three mnemonics for the or instmction; orb, orw, and 
or 1, meaning or byte, or word, and or long, respectively. 

Instmction mnemonics for instmctions with unusual opcodes may have addi¬ 
tional suffixes. Thus in addition to the normal add variations, there also exist 
addqb, addqw and addql for the instmction. 

Branch instmctions come in two flavors for the MC68010, byte (or short) and 
word, and an additional flavor, long, for the MC68020. Append the suffix s to 
the word mnemonic to specify the short version of the instmction. For example, 
beq refers to the word version of the Branch if Equal instmction, beqs refers to 
the short version, wlule beql refers to the long versioa 

6.2. Extended Branch In addition to the instmctions which explicitly specify the instmction length, as 

Instruction Mnemonics supports extended branch instmctions, whose names are, in most cases, con- 

stmcted from the word versions by replacing the b with j. 

If the operand of the extended branch instmction is a simple address in the text 
segment, and the offset to that address is sufficiently small, as automatically 
generates the corresponding short branch instmction. 

If the offset is too large for a short branch, but small enough for a branch, the 
corresponding branch instmction is generated. If the operand references an 
external address or is complex (see next paragraph), the extended branch 
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instruction is implemented either by a jmpor jsr(for jra or jbsr), or (for 
the MC68010) by a conditional branch (with the sense of the condition inverted) 
around a jmp for the extended conditional branches and (for the MC68020) the 
corresponding long branch. 

The extended mnemonics should only be used in the text segment ^ if they are 
used in the data segment, the most general form of the branch is generated. 

In this context, a complex address is either an address which specifies other than 
normal mode addressing, or a relocatable expression containing more than one 
relocatable symbol. For instance, if a, b and c are symbols in the current seg¬ 
ment, the expression a+b-c is relocatable, but not simple. 

Consult Appendix B for a complete list of the instruction opcodes. 

6.3. Addressing Modes Table 6-1 below describes the addressing modes that asrecognizes. Note that 

certain modes are not valid for the MC68010. The notations used in this table 
have these meanings: 


Notation 

Meaning 

an 

An address register. 

dn 

A data register. 

ri 

Either a data register or an address register. 

fi 

A floating-point register. 

d 

A displacement, which is a constant expression in as. In 
MC68020 mode, a length specifier (: L, described below) may be 
appended to the displacement. Any forward or external refer¬ 
ences require the length specifier to be : 1. AU other references 
permit either : 1 or : w or nuUs. 

L 

The index register’s length. This may be either long (1) or word 
(w) or null. If the only value permitted by a particular addressing 
mode or category is 1 or w, then L will be replaced by the 
appropriate value in the table notation. 

s 

A scale factor that may be used to multiply the index register’s 
length. The scale factor may have a value of 1,2,4, or 8. 


The table notation of two or three items separated by colons, such as ri: L: s, 
indicate items that may be optional. In that particular case, you may not specify 
: s unless you have specified :L, which you may not specify unless you have 
specified r/. The items in the list must appear in the order given in the notation 
of the tables that follow. 

In the table where both d and d’ are specified, d corresponds to a MC68020 outer 
displacement and d’ corresponds to a MC68020 base displacement. 

XXX refers to a constant expression. 
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Certain instructions, particularly move, accept a variety of special registers 
including: 


Name 

Register 

sp 

the stack pointer, which is equivalent to a 7 

sr 

the status register 

cc 

the condition codes of the status register 

usp 

the user mode stack pointer 

pc 

the program coimter 

sf c 

the source function code register 

df c 

the destination function code register 

fpcr 

the floating-point control register 

fpsr 

the floating-point status register 

fpiar 

the floating-point instruction address register 


The memory-indirect and program counter memory-indirect addressing modes 
listed in the following tables are usable only with the MC68020. 

In each of these addressing modes, up to four user-specified values are used to 
generate the final operand address: 

□ base register 

p base displacement 

□ index register 

□ outer dispacement 

All four user-specified values are optional. Both base and outer displacements 
may be null, word or long. When a displacement is nuU, or an element is 
suppressed, its value is taken as zero in the effective address calculation. 

In the case of memory-indirect addressing, an address register (an) is used as a 
base register, and its value can be adjusted by an optional base displacement (d’). 
An index register {r0 specifies an index operand (ri: L: s) and finally, an outer 
displacement (d) can be added to the address operand, yielding the effective 
address. 

Program coimter memory-indirect mode is exactly the same. The only difference 
is that the program counter is used as the base register. 

Some examples of these addressing modes foUow: 
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an@ id' : L, ri:L:s)@(d:L) 
an@(d:L)@(d’ :L,ri:L:s) 
an@@ 
an@(d:L)@ 
an@(d’ :L,ri:L:s)@ 
pc@@ 
pc@(d:L)@ 
pc@(d’ :L,ri:L:s)@(d:L) 
pc@( d:L)@( d’ :L,ri:L:s) 

@(d:L)@ 

@(d’ :L,ri:L:s)@(d:L) 

@(d:L)@(d’ :L,ri:L:s) 

@(d’ :L,ri:L:s)@ 

V_^_/ 


In the table below, note that the notation ri/rj means ri and rj, while n_Tj means ri 
through rj. 


Table 6-1 Addressing Modes 


Mode 

Notation 

Example 

Register 

an, dn, sp,pc,cc,sr,usp 

movw a3,d2 

Register Deferred 

an@ 

movw a3@,d2 

Register List 

ri-rj or ri/rj 

movem a0-a4, a6@- 

FPA register 

fpai 

fpmoves fpal,d2 

Floating-Point Register 

fpi 

fmoves fpl,a3@(24) 

(MC68881 only) 



Postincrement 

a«@+ 

movw a3@+,d2 

Predecrement 

a«@- 

movw a3@-,d2 

Displacement 

an@ (4) 

movw a3@(24),d2 

Word Index 

an@ (4, r«:w) 

movw a3@(16, d2:w),d3 

Long Index 

an@ (4, ri: 1) 

movw a3@(16, d2:l),d3 

Absolute Short 

XXXIW 

movw 14:w,d2 

Absolute Long 

xxx: 1 

movw 14:l,d2 

PC Displacement 

pc@ (4) 

movw pc@(20),d3 

PC Word Index 

pc@ (4, ri:w) 

movw pc@(14, d2:w),d3 

PC Long Index 

pc@ (4, ri: 1) 

movw pc@(14, d2:l),d3 

PC-Memory Indirect 

pc@ (d' :L,ri:L:s)@ (d:L) 

movl pc@(2:w,d4:w:4)@(14:1) , d3 

Pre-Indexed (68020) 



PC-Memory Indirect 

pc@ (d:L) @ (d' :L, ri: L: s) 

movl pc@ (d: 1) @ (3: w, d2:1: 4) , d3 

Post-Indexed (68020) 



Memory Indirect 

an@ (4’ :L, ri:L: s) @ (d:L) 

movl al@(d:L,d2:l:4)@(14:w) 

Pre-Indexed (68020) 



Memory Indirect 

an@(4:L)@ (d' :L,ri:L:s) 

movl a2@ (2 :w) @ (14 :w, d4 :w: 2) 

Post-Indexed (68020) 
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Table 6-1 Addressing Modes — Continued 


Mode 

Notation 

Example 

Nonnal 

identifier 

movw widget,d3 

Immediate 

#xcr 

movw #27+3,d3 


Normal mode assembles as PC-relative if the assembler can determine tiiat this is 
appropriate, otherwise it assembles as either absolute short or absolute long, 
under control of the -62 command line option. 

The Motorola manuals present different nmemonics (and in fact different forms 
of the actual machine instructions) for instructions that use the literal effective 
address as data instead of using the contents of the effective address. For 
instance, they use the mnemonic adda for add address, as does not make 
these distinctions because it can determine die type of opcode required from the 
fonn of the operand. Thus an instruction of the form: 


r 

avenue: .word 0 


addl #avenue,aO 

j 

assembles to the add address instruction because 
address register. 

as can determine that aO is an 

r 

right_now: = 40000 

\ 

addl #right_now,dO 

_ 



assembles to an add immediate instruction because as can determine that 
right jum is a constant. 

Because of this determination of operand forms, some of the mnemonics listed in 
the Motorola manuals are missing from the set of mnemonics that as recognizes. 

Certain classes of instructions accept only subsets of the addressing modes 
above. For example, the add instruction does not accept a PC-relative address as 
a destination, and register lists may be used only with the movem and fmovem 
instmctions. 

as tries to check all these restrictions and generates the illegal operand error 
code for instructions that do not satisfy the address mode restrictions. 

The next section describes how the address modes are grouped into addressing 
categories. 
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6.4. Addressing Categories The processors group the effective address modes into categories derived from 

the manner in which they are used to address operands. Note the distinction 
between address modes and address categories. There are 14 addressing modes 
in the MC68010 and 18 in the MC68020, and they fall into one or more of four 
addressing categories. The addressing categories are defined here, followed by a 
table summarizing the grouping of the addressing modes into categories. Note 
that register lists can be used only by the movem and fmovem instructions. 


Category 

Meaning 

Data 

means that the effective address mode is used to refer to data 
operands such as a d register or immediate data. 

Memory 

means that the effective address mode can refer to memory 
operands. Examples include aU the a-register indirect address 
modes and all the absolute address modes. 

Alterable 

means that the effective address mode refers to operands which 
are writeable (alterable). This category takes in eveiy addressing 
mode except the PC-relative addressing modes and the immedi¬ 
ate address mode. 

Control 

means that the effective address mode refers to memory 
operands with no explicit size specification. 


Some addressing categories can be intersected to make more restrictive ones. 
For example, the Motorola MC68010 manual mentions the Data Alterable 
Addressing Mode to mean that the particular instruction can only use those 
modes which provided data addressing and are alterable as well. 


Table 6-2 Addressing Categories 


Addressing 

Mode 

Assembler 

Syntax 

Data 

Memory 

Control 

Alterable 

MC68020 

Only 

Register Direct 

a.n, 6nr sp, pCf 
cc, sr, usp 

X 



X 


A-Register Indirect 

anS 

X 

X 

X 

X 


A-Register Indirect 
with Displacement 

a«@ (d:L) 

X 

X 

X 

X 

X 

A-Register Indirect 
with Word Index 

an@ (d:L, rt: w: s) 

X 

X 

X 

X 

X 

A-Register Indirect 
with Long Index 

a«@ (d: L, r/: 1: s) 

X 

X 

X 

X 

X 

A-Register Indirect 
with Post Increment 

an@ + 

X 

X 


X 


A-Register Indirect 

with Pre Decrement 

an@- 

X 

X 


X 
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Table 6-2 Addressing Categories — Continued 


Addressing 

Mode 

Assembler 

Syntax 

Data 

Memory 

Control 

Alterable 

MC68020 

Only 

A-Register Indirect 
with Displacement 

an@ (d) 

X 

X 

X 

X 


A-Register Indirect 
with Word Index 

an@ (d, rf: w) 

X 

X 

X 

X 


A-Register Indirect 
with Long Index 

an@ {d, rz:l) 

X 

X 

X 

X 


Memory-Indirect 

Post-Indexed 

a«@ (d.-L) @ (d' :L,rz:L:s) 

X 

X 

X 

X 

X 

Memory-Indirect 

Pre-Indexed 

an@ (d' :L, rz:L: s) 0 (d:L) 

X 

X 

X 

X 

X 

Absolute Short 

xrc: w 

X 

X 

X 

X 


Absolute Long 

XXXll 

X 

X 

X 

X 


PC-relative 

pc@ (d) 

X 

X 

X 



PC-Indirect 
with Displacement 

pc@ (d:L) 

X 

X 

X 


X 

PC-relative with 

Word Index 

pc@ {d, rz: w) 

X 

X 

X 



PC-Indirect with 

Word Index 

pc@ (z/: L, rz’: w: s) 

X 

X 

X 


X 

PC-relative 
with Long Index 

pc@ (d, rz: 1) 

X 

X 

X 



PC-Indirect with 

Long Index 

pc0 (d: L, rz’: 1: s) 

X 

X 

X 


X 

PC-Memory Indirect 
Post-Indexed 

pc@ (d:L) 0 (d' :L, rz’:L:s) 

X 

X 

X 

X 

X 

PC-Memory Indirect 
Pre-Indexed 

pc0 (d' :L,rz’:L:s) 0 (d:L) 

X 

X 

X 

X 

X 

Immediate Data 

#«nn 

X 

X 
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as Error Codes 


A.1. Usage Errors 

The specified output file cannot be created. Check that the permissions 
allow opening this file. 

Cannot open source file 

The assembler caimot open the specified source file. Check the spelling, that 
the pathname supplied is correct, and that you have read permission for the 
file. 


No input file 

One or more input files must be specified — as cannot accept the output of 
a pipe as its input. 


Too many file names given 

The assembler cannot cope with more than one source file. Break the job 
into smaller stages. 


, Unknown option ‘x’ ignored 

as does not recognize the option x. Valid options are listed in Section 1.1 of 
this manual. 

A.2. Assembler Error If as detects any errors during the assembly process, it prints out a message of 

Messages the form: 


c 

A 

as: error {Kline_no>) : <error_code> 


- ..—- 

) 


Error messages are sent to standard error. Here is a list of as error codes, and 
their possible causes. 


Illegal .align 

The expression following a . align evaluates to some value other than 1, 2 
or 4. 



51 
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Invalid assignment 

An attempt was made to redefine a label with a direct assignment statement. 


Invalid Character 

An unexpected character was encoimtered in the program text. 


Invalid Constant 

An invalid digit was encountered in a number. For example, using an 8 or 9 
in an octal number. Also happens when an out-of-range constant operand is 
found in an instruction — for example: 


addq #200,dO 
asll #12,dO 


Invalid opcode 

The assembler did not recognize an instruction mnemonic. Probably a 
misspelling. 

Invalid operand 


The operand used is not consistent with the instruction used — for example: 


( 


\ 


addqb #l,a5 


V_ 


___J 


is an invalid combination of instruction and operand. Check the instruction 
set descriptions for valid combinations of instructions and operands. 


Invalid Operator 

Check the operand field for a bad operator. The operators that as recog¬ 
nizes are plus (-t), minus (-), negate or one’s complement (~), multiply 
(*), and divide (/). 


Invalid register expression 

A register name was found where one should not appear—for example: 


addl #d0,_there 


Invalid Register List 

The register list in a movem or fmovem instruction is malformed. Note 
that the list must contain more than one register name: to express a list con¬ 
taining just a single register, you must write its name twice separated by a 
slash, e.g. fpO/fpO." 
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Invalid string 

An invalid string was encountered in an .ascii or .asciz directive. 

□ Make sure the string is enclosed in double quotes. 

□ Remember that you must use the sequence \" to represent a quote inside 
a string. 

Invalid symbol 

An operand that should be a symbol is not — for example: 

---- V 

.globl 3 


because the constant 3 is not a symbol. 


Invalid Term 

The expression evaluator could not find a valid term: a symbol, constant or 
<expression>. 

An invalid prefix to a number or a bad symbol name in an operand gen¬ 
erates this message. 

Une too long 

A statement was found which has more than 4096 characters before the new- 
line character. 

Missing close-paren ’)' 

An unmatched ‘(’ was found in an expression. 

Multiply defined symbol 

o An identifier appears twice as a label. 

□ An attempt to redefine a label using a direct assignment statement. 

a An attempt to use, as a label, an identifier which was previously defined 
in a direct assignment statement. 


Multiply Defined Symbol (Phase Error) 

This rarely occurring message indicates an inconsistency in the assembler. 
Report it to Sun Microsystems Customer Support if it occurs. 


Non-relocatable expression 

If an expression contains a relocatable symbol (a label, for instance), the 
only operations that can be applied to it are the addition of absolute expres¬ 
sions or the subtraction of another relocatable symbol (which produces an 
absolute result). 
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Odd address 

The previous instruction or pseudo-op required an odd number of bytes and 
this instruction requires word alignment. This error can only follow an 
.ascii, an .asciz,a .byte, ora . skip pseudo-operation. 

NOTE Use a .even directive to ensure that the location counter is forced to a 16-bit 
boundary. 

Ojfset too large 

The instruction is a relative addressing instruction and the displacement 
between this instraction and the label specified is too large for the address 
field of the instruction. 


Out of strings space 

No more room is left in the assembler’s internal string table. Divide the pro¬ 
gram into smaller portions; assemble portions of the program separately, 
then bind them together using the linker. 


Register out cf range 

In the FPA’s dot product, matrix move and transpose instructions when the 
register specified does not fall within the specified range, then this error is 
reported. Note that for most instructions where one operand is an effective 
address, the register range is 0 to 15. If all operands are FPA registers, the 
register range is 0 to 31. For constant RAM registers, the range is 0 to 511. 
This type of error would probably also cause the Invalid operand error to be 
reported. 

Stab storage exceeded 

No more room is left in the assembler’s symbol table for debug information. 
Cut the program into smaller portions; assemble portions of the program 
separately, then bind them together using the linker. 

Symbol storage exceeded 

No more room is left in the assembler’s symbol table. Divide flie program 
into smaller portions; assemble portions of the program separately, then bind 
them together using the linker. 


Symbol Too Long 

A local label reference longer than one digit was found. 
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Undefined L-symbol 

This is a warning message. A symbol beginning with the letter ‘L’ was used 
but not defined. It is treated as an external symbol. Compiler-generated 
labels usually start with the letter ‘L’ and should be defined in this assembly. 
The absence of such a definition usually indicates a compiler code genera¬ 
tion error. This message is also generated by the use of symbols such as «$ 
if «$ has not been defined. 


Unqualified forward reference 

The displacement field in an MC68020 based/indexed address mode con¬ 
tains an unqualified forward reference. Note that the displacement in a 
based/mdexed address mode for the MC68020 instruction set can contain a 
forward or external reference only if the length specifier is present. The 
length specifier should be : 1 (long). This type of error would probably also 
cause Multiply defined symbol (Phase error). 

Undefined Symbol 

A label reference to an undefined local label was found. 


Wrong number of operands 

Check Appendix B for the correct number of operands for the current 
instruction. 



microsystems 


Revision A of May 9, 1988 





I 




s 









List of as Opcodes 


List of as Opcodes 


59 



























List of as Opcodes 


This appendix is a list of the instruction mnemonics accepted by as, grouped 
alphabetically. The list is divided into two tables, the first covers the MC680x0 
processor’s instructions, the second covers the MC68881 floating-point 
processor’s instructions. For more information about floating-point program¬ 
ming, see the Floating-Point Programmer’s Guide. 

Each entry describes the following things: 

□ The mnemonics for the instruction, 

□ The generic name of the instruction, 

p The assembly language syntax and the variations on the instruction, 

□ Whether the instruction is specific to the MC68020, or has extended capabil¬ 
ities on the MC68020 compared to the MC68010. 

The syntax for as machine instructions differs somewhat from the instruction 
layouts and categories shown in the Motorola processor manuals. For example, 
as provides a single set of mnemonics for add (add binary), adda (add 
address), and addi (add immediate), differentiated only by the length of the 
operands. In general, as selects the appropriate instruction from the form of the 
operands. 

Here is a brief explanation of the notations used below. 


□ An instruction of the form addx in the assembly language syntax column 
means that the instruction is coded as addb, addw, addl, etc. 

o An operand field of an means any A-register. 

o An operand field of dn means any D-register. 

n An operand field of rn means any A- or D-register. 

□ An operand field of fn means any fioating-point register. 

□ An operand field of cn means any control register. 

□ An operand field of ea means an effective address designated by one of the 
permissible addressing modes. Consult the relevant Motorola processor 
manual for details of the allowed addressing modes for each instmction. 
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□ An operand field of vector means an exception vector location. 

□ An operand field of #data means an immediate operand. 

□ Other special registers such as cc (condition code register) and sr (status 
register) are specifically indicated where appropriate. 

The MC68020 provides a set of bit-field manipulating instructions that don’t 
exist on the MC68010. Their notation includes a bit field specifier of the form 
{ojfsef.width}, where the offset denotes the beginning of the bit field in the word 
and the width is the number of bits in the field. 

Offset values are counted from the high-order bit, as 0, to the low-order bit, as 
31. 

NOTE This ordering is the reverse of the convention used in the bchg, bclr, bset, 
anrfbtst instructions. 

Offset and width may be either constants or data registers. For example: 
o bfins d0,a5e(4){#0:#9} 

□ bfexta a5@(4){dO:#8},d7 

In the table that follows, the processor is assumed to be the MC68010 unless 
specifically stated otherwise. 


Table B-1 List ofMC680x0 Instruction Codes 


Mnemonic 

Operation Name 


Syntax 

Processor 

abed 

add decimal with extend 

abed 

dy, 6x 




abed 

ay@-,aX@- 


addb 

add binary 

addX 

ea, dn 


addw 


addX 

dn,ea 


addl 


addX 

ea,an (except addb) 




addX 

%data, ea 


addqb 

add quick 

addqX 

§data, ea 


addqw 





addql 





addxb 

add extended 

addxX 

dy, dX 


addxw 


addxX 

ay@-,aX@- 


addxl 





andb 

logical and 

andX 

ea, dn 


andw 


andX 

dn,ea 


andl 


andX 

§data, dn 


aslb 

arithmetic shift left 

aslX 

dX, dy 


aslw 


aslX 

#data, dy 


asll 


aslX 

ea 
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Table B -1 List ofMC680x0 Instruction Codes — Continued 


Mnemonic 

Operation Name 


Syntax 

Processor 

asrb 

arithmetic shift right 

asrX 

dX, dy 


asrw 


asrX 

%data, dy 


asrl 


asrX 

ea 


bcc 

branch conditionally 

beeX 

label 


bed 




MC68020 

bees 





bchg 

test a bit and change 

bchg 

dn, ea 




bchg 

%data, ea 


bclr 

test a bit and clear 

bclr 

dn, ea 




bclr 

idata, ea 


bkpt 

breakpoint 

bkpt %data 

MC68020 

bset 

test a bit and set 

bset 

dn, ea 




bset 

%data, ea 


btst 

test a bit 

btst 

dn, ea 




btst 

§data, ea 


bfchg 

test a bit field and change 

bfchg 

ea{offset .-width) 

MC68020 

bfolr 

test a bit field and clear. 

bf clr 

ea{offset:width) 

MC68020 

bfexts 

extract a bit field signed 

bfexts ea{offset.-width}, dn 

MC68020 

bfextu 

extract a bit field unsigned 

bfextu ea{offset.-width), dn 

MC68020 

bfffo 

find first one in bit field 

bfffo 

ea{offset:width}, dn 

MC68020 

bf ins 

insert a bit field 

bf ins 

dn, ea{offset :width) 

MC68020 

bfset 

test a bit field and set 

bfset 

ea{offset .-width) 

MC68020 

bftst 

test a bit field 

bftst 

ea{offset.-width) 

MC68020 

bes 

branch carry set 

besX 

ea 


bcsl 




MC68020 

boss 





beq 

branch on equal 

beqX 

ea 


beql 




MC68020 

beqs 





bge 

branch greater or equal 

bgeX 

ea 


bgel 




MC68020 

bges 





bgt 

branch greater than 

bgtX 

ea 


bgtl 




MC68020 

bgts 
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Table B -1 List ofMC680x0 Instruction Codes— Continued 


Mnemonic 

Operation Name 


Syntax 

Processor 

bhi 

branch higher 

bhiZ 

ea 


bhil 




, MC68020 

bhis 





ble 

branch less than or equal 

bley 

ea 


blel 




MC68020 

bles 





bis 

branch lower or same 

blsX^ 

ea 


blsl 




MC68020 

bit 

branch less than 

bltX 

ea 


bltl 





bits 





biiii 

branch minus 

bmiX 

ea 


bmil 





bmis 





bne 

branch not equal 

bneX 

ea 


bnel 




MC68020 

bnes 





bpl 

branch positive 

bplY 

ea 


bpll 




MC68020 

bpls 





bra 

branch always 

braX 

label 


bral 




MC68020 

bras 





bsr 

subroutine branch 

bsrX 

label 


bsrl 




MC68020 

bsrs 





bvc 

branch overflow clear 

bvcY 

ea 


bvcl 




MC68020 

bvcs 





bvs 

branch overflow set 

bvsX 

ea 


bvsl 


bvsl 


MC68020 

bvss 





callm 

call module 

callm 

tdata, ea 

MC68020 

cas2b 

compare & swap with operand 

cas2X 

del:dc2, dMl:d«2, (rnl) : (rra2) 

MC68020 

cas21 




MC68020 

cas2w 




MC68020 

casb 

compare & swap with operand 

casX dc, dtt, ea 

MC68020 

casl 




MC68020 

casw 




MC68020 
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Table B-1 List ofMC680x0 Instruction Codes — Continued 


Mnemonic 

Operation Name 


Syntax 

Processor 

chkb 

chkw 

chkl 

check register against bounds 

chkX 

ea, dn 

MC68020 

MC68020 

, MC68020 

chk2b 

chk21 

chk2w 

check register against bounds 

chk2X 

ea, rn 

MC68020 

MC68020 

MC68020 

clrb 

clrw 

clrl 

clear an operand 

clrX 

ea 


cmp2b 

cit5)21 

citp2w 

compare register against bounds 

cmp2X 

ea, rn 

MC68020 

MC68020 

MC68020 

cmpmb 

cmpmw 

cmpml 

compare memory 

cmpmX 

a.yQ+,aXQ+ 


cmpb 

cmpw 

cmpl 

arithmetic compare 

cmpX 

cmpX 

ea, dn 
%data, ea 


dbcc 

decrement & branch on carry clear 

dbcc 

dn, label 


dbcs 

" on carry set 

dbcs 

dn, label 


dbeq 

" on equal 

dbeq 

dn, label 


dbf 

" on false 

dbf dn, label 


dbge 

" on greater than or equal 

dbge 

dn, label 


dbgt 

" on greater than 

dbgt 

d«, label 


dbhi 

" on high 

dbhi 

dn, label 


dble 

" on less than or equal 

dble 

dn, label 


dbls 

" on low or same 

dbls 

dn, label 


dblt 

" on less than 

dblt 

dn, label 


dbmi 

" on minus 

dbmi 

dn, label 


dbne 

" on not equal 

dbne 

dn, label 


dbpl 

'' on plus 

dbpl 

dn, label 


dbra 

" always (same as dbf) 

dbra 

dn, label 


dbt 

" on True 

dbt d/i, label 


dbvc 

" on overflow clear 

dbvc 

dn, label 


dbvs 

" on overflow set 

dbvs 

dn, label 


divs 

signed divide 

divs 

ea, dn 


divsl 


divsX 

ea, dn 

MC68020 

divsll 


divsX 

divsX 

ea, dq 
ea, dridq 

MC68020 

MC68020 

divu 

unsigned divide 

divu 

ea, drt 


divul 


divuX 

ea, dn 

MC68020 
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Mnemonic 


divuw 

divull 


extbl 

extw 

extl 


Table B -1 List ofMC680x0 Instruction Codes — Continued 


_ Operation Name _ Syntax 





logical exclusive or 


exchange registers 


sign extend 


jump 

jump to subroutine 
jump carry clear 
jump on carry 
jump on equal 
jump greater or equal 
jump greater than 
jump higher 

jump less than or equal 

jump lower or same 

jump less than 

jump minus 

jump not equal 

jump positive 

jump always 

jump to subroutine 

jump no overflow 

jump on overflow 


divuX ea, d/i 
divuX ea,<iq 
divuX ea,6r-.6q 
divull ea,dr:d^ 


eorX 6n,ea 
eorX %data,ea 
eorb idata, cc 
eorw %data,sr 


exg rr, ry 


extbl dn 
extX dn 


ymp ea 
jsr ea 
jcc ea 
jcs ea 
jeq ea 
jge ea 
jgt ea 
jhi ea 
jle ea 
jls ea 
jit ea 
jmi ea 
jne ea 
jpl ea 
jra ea 
jbsr ea 
jvc ea 
jvs ea 


Processor 


MC68020 

MC68020 

MC68020 

MC68020 



MC68020 


lea 

load effective address 

lea 

ea, an 

link 

link and allocate 

link 

an, %disp 

linkl 


linkl 

an, %disp 

Islb 

logical shift left 

IslX 

dx,dy 

Islw 


IslX 

tidata, dy 

Isll 


IslZ 

ea 

Isrb 

logical shift right 

IsrX 

dr, dy 

Isrw 


IsrX 

%data, dy 

Isrl 


IsrX 

ea 

movb 

move data 

movX 

ea,ea 

movl 




movw 


movX 

%data, dn 


MC68020 
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Table B -1 List ofMC680jd0 Instruction Codes — Continued 


Mnemonic 

Operation Name 

Syntax 

Processor 

movw 

movw 

move 

move from condition code register 
move from status register 
move to/from control register 

movw cCf ea 

movw BT,ea 

move rn, or 

move or, rn 


moveml 

movemw 

move multiple registers 

movemX imask, ea 
movemX ea,%mask 
movemy ea,reglist 
movemy reglist, ea 


movepl 

movepw 

move peripheral 

movepy dn,a«@ (d) 
movepy an@(d),dn 


moveq 

move quick 

moveq %data, dn 


movsb 

movsw 

movsl 

move to/from address space 

movsy rn, ea 
movsy ea, rn 


muls 

mulslw 

mulsll 

signed multiply 

muls ea,dn 
mulsy ea,<3l 
mulsy ea,dh:dd 

MC68020 

MC68020 

mulu 

mulul 

unsigned multiply 

mulu ea,<in 
muluX ea,dl 
muluy ea,dh:dl 

MC68020 

MC68020 

nbed 

negate decimal with extend 

nbed ea 


negb 

negw 

negl 

negate binary 

negy ea 


negxb 

negxw 

negxl 

negate binary with extend 

negxy ea 


nop 

no operation 

nop 



logical complement 

noty ea 


orb 

orw 

orl 

inclusive or 

orX ea,dn 
orX dn, ea 
or %data,ea 

orb #data,cc 
orw %data,sr 


pack 

pack 

pack ay@-, ay@-, #dafa 
pack dy, dy,#daffl 

MC68020 

MC68020 

pea 

push effective address 

pea ea 
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66 Assembly Language Reference 


Table B -1 List ofMC680x0 Instruction Codes — Continued 


Mnemonic 

Operation Name 

Syntax 

Processor 

reset 

reset device 

reset 


rolb 

rotate left 

rolZ dr, dy 


rolw 

rotate left 

rolZ %data, dy 


roll 


rolZ ea 


rorb 

rotate right 

rorZ dr, dy 


rorw 


rorZ idata, dy 


rorl 


rorZ ea 


roxlb 

rotate left with extend 

roxlZ dr, dy 


roxlw 


roxlZ 4data,dy 


roxll 


roxlZ ea 


roxrb 

rotate right with extend 

roxrZ dr, dy 


roxrw 


roxrZ %data,dy 


roxrl 


roxrZ ea 


rtd 

return and deallocate parameters 

rtd #data 


rte 

return from exception 

rte 


rtm 

return from module 

rtm r« 

MC68020 

rtr 

return and restore codes 

rtr 


rts 

return from subroutine 

rts 




rts #« 


sbcd 

subtract decimal with extend 

sbcd dy,dr 
sbcd ay@-, aZ@- 


stop 

halt machine 

stop #rrr 


subb 

arithmetic subtract 

subZ ea,dn 


subw 


subZ dn,ea 
subZ ea,an 


. subl 


subZ %data,ea 


St 

set all ones 

St ea 


sf 

set all zeros 

sf ea 


shi 

set high 

shi ea 


sis 

set lower or same 

sis ea 


see 

set carry clear 

see ea 


scs 

set carry set 

scs ea 


sne 

set not equal 

sne ea 


seg 

set equal 

seg ea 


sve 

set no overflow 

SVC ea 


svs 

set on overflow 

svs ea 


spl 

set plus 

spl ea 


smi 

set minus 

smi ea 


sge 

set greater or equal 

sge ea 


sit 

set less than 

sit ea 


sgt 

set greater than 

sgt ea 


sle 

set less than or equal 

sle ea 
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Table B -1 List of MC680xO Instruction Codes — Continued 


Mnemonic 

Operation Name 

Syntax 

Processor 

subqb 

subqw 

subql 

subtract quick 

subtract quick 

subqJf %data,ea 


subxb 

subxw 

subxl 

subtract extended 

subxX dy, dx 
subxX ay@-,3X0- 


swap 

swap register halves 

swap dn 


tas 

test operand then set 

tas ea 


trap 

trap 

trap %vector 


trapcc 

trapccl 

trapccw 

trap on carry clear 

trapeeX 
trapeeX #data 

MC68020 

MC68020 

MC68020 

trapes 

trapcsl 

trapesw 

trap on carry set 

trapesx 
trapesX %data 

MC68020 

MC68020 

MC68020 

trapeq 

trapeql 

trapeqw 

trap on equal 

trapeqX 
trapeqX %data 

MC68020 

MC68020 

MC68020 

trapf 
trapf1 
trapfw 

trap on never true 

trapfX 
trapfX #dafa 

MC68020 

MC68020 

MC68020 

trapge 

trapgel 

trapgew 

trap on greater or equal 

trapgeX 
trapgeX %data 

MC68020 

MC68020 

MC68020 

trapgt 

trapgtl 

trapgt 

trap on greater 

trapgtX 
trapgtX #data 

MC68020 

MC68020 


The following table describes the MC68881 instruction mnemonics supported by 
as. 

Each mnemonic indicates the data type that it operates on by the last character of 
the mnemonic: 

o b indicates a byte format instruction 

□ w indicates a word format instruction 

□ 1 indicates a long format instruction 

□ s indicates a single-precision format instmction 

□ d indicates a double-precision format instmction 
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68 Assembly Language Reference 


□ X indicates an extended-precision format instruction 

□ p indicates a packed format instruction 

n y indicates that any of 1, s, p, w, d, or b, are acceptable. 



Table B-2 

MC68881 Instructions supported by as 


Mnemonic 


Operation Name 

Syntax 

fabsx 


absolute value 

fabsx ea, fn 

fabsl 



fabsx fm, fn 

fabss 



fabsy ea,fn 

fabsp 




fabsw 




fabsd 




fabsb 




facosx 


arc cosine 

facosx ea,fn 

facosl 



facosx fm, fn 

facoss 



facosy ea, fn 

facosp 




faoosw 




facosd 




facosb 




faddx 


add 

faddx ea, fn 

faddl 



faddx fm,fn 

fadds 



faddy ea,fn 

faddp 




faddw 




faddd 




faddb 




fasinx 


arc sin 

fasinx ea,fn 

fasinl 



fasinx fm, fn 

fasins 



fasiny ea, fn 

fasinp 




fasinw 




fasind 




fasinb 




fatanx 


arc tangent 

fatanx ea,fn 

fatanl 



fatanx fm, fn 

fatans 



fatany ea, fn 

fatanp 




fatanw 




fatand. 




fatanb 




fatanhx 


hyperbolic arc tangent 

fatanhx ea, fn 

fatanhl 



fatanhx fm,fn 

fatanhs 



fatanhy ea, fn 
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Table B-2 

MC68881 Instructions supported by as— Continued 


Mnemonic 

Operation Name 

Syntax 


fatanhp 

fatanhw 

fatanhd 

fatanhb 

fbcc 

fbeq 

fbeql 

fbf 

fbfl 

fbgt 

fbgtl 

fble 

fblel 

fblt 

fbltl 

fbge 

fbgel 

fbgl 

fbgll 

fbgle 

fbglel 

fbgt 

fbne 

fbnel 

fbneq 

fbneql 

fbnge 

fbngel 

fbngl 

fbngll 

fbngle 

fbnglel 

fbngt 

fbngtl 

fbnle 

fbnlel 

fbnlt 

fbnltl 

fbt 

fbtl 

fbor 

fborl 

fboge 

fbogel 

fbogl 


hyperbolic arc tangent (corUd.) 

branch conditionally 
(equal) 

(false) 

(greater than) 

(less than or equal) 

(less than) 

(greater than or equal) 

(greater than or less) 

(greater less or equal) 

(greater than) 

(not equal) 

(not (equal)) 

(not greater than or equal) 
(not greater than or less) 
(not greater than, less or equal) 
(not greater than) 

(not less than or equal) 

(not less than) 

(true) 

(ordered) 

(ordered greater or equal) 
(ordered greater or less) 


fbcc label 
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Table B -2 MC68881 Instructions supported by a s— Continued 


Mnemonic 

Operation Name 

Syntax 

fbogll 



fbogt 

fbogtl 

(ordered greater than) 


fbole 

fbolel 

(ordered less or equal) 


fbolt 

fboltl 

(ordered less than) 


fbseq 

fbseql 

(signalling equal) 


fbsf 

fbsfl 

(signalling false) 


fbsne 

fbsnel 

(signalling not equal) 


fbst 

fbstl 

(signalling true) 


fbueq 

fbueql 

(unordered equal) 


fbuge 

fbugel 

(unordered greater or equal) 


fbugt 

fbugtl 

(unordered greater than) 


fbule 

fbulel 

(imordered less or equal) 


fbult 

fbultl 

(unordered less than) 


fbun 

fbunl 

(unordered) 


fcmpx 

compare 

fcmpx ea, tn 

fcit5>l 


fcmpx fm,fn 

f cmps 
fcmpp 
fcmpw 
fcmpd 
fcmpb 


fcmpy ea, fn 

fcosx 

cosine 

fcosx ea, fn 

fcosl 


fcosx fm,fn 

f coss 

fcosp 

f cosw 

fcosd ' 

fcosb 


fcosy ea, fn 

fcoshx 

hyperbolic cosine 

fcoshx ea, fn 

fcoshl 


fcoshx fm, fn 

fcoshs 


fcoshy ea, fn 
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Table B-2 MC68881 Instructions supported by as— Continued 


Mnemonic 

Operation Name 

Syntax 

fcoshp 



fcoshw 

fcoshd 

fcoshb 

hyperbolic cosine (contd.) 


fdbcc 

decrement & branch on condition 

fdbcc dn, label 

fdbeq 

(equal) 


fdbne 

(not equal) 


fdbgt 

(greater than) 


fdbngt 

(not greater than) 


fdbge 

(greater or equal) 


fdbnge 

(not greater or equal) 


fdblt 

(less than) 


fdbnlt 

(not less than) 


fdble 

(less or equal) 


fdbnle 

(not less or equal) 


fdbgl 

(greater or less) 


fdbngl 

(not greater or less) 


fdbgle 

(greater, less or equal) 


fdbngle 

(not greater, less or equal) 


fdbogt 

(ordered greater than) 


fdbule 

(unordered less or equal) 


fdboge 

(imordered greater or equal) 


fdbult 

(unordered less than) 


fdbolt 

(ordered less than) 


fdbuge 

(unordered greater or equal) 


fdbole 

(ordered less or equal) 


fdbugt 

(unordered greater than) 


fdbogl 

(ordered greater or less) 


fdbueq 

(unordered equal) 


fdbor 

(ordered) 


fdbun 

(unordered) 


fdbf 

(false) 


fdbt 

(true) 


fdbsf 

(signalling false) 


fdbst 

(signalling true) 


fdbseq 

(signalling equal) 


fdbsne 

(signalling not equal) 


fdivx 

divide 

fdivx ea, fn 

fdivl 


fdivx fm ,fn 

fdivs 

fdivp 

fdivw 

fdivd 

fdivb 


fdivy ea,fn 
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Table B-2 MC68881 Instructions supported by a s— Continued 


Mnemonic 

Operation Name 

Syntax 

fetoxx 

X 

e 

fetoxx ea, fn 

fetoxl 


fetoxx f/n, fn 

fetoxs 

- 

fetoxy ea, fn 

fetoxp 



fetoxw 



fetoxd 



fetoxb 



fetoxmlx 

X 1 
e -1 

fetoxmlx ea,fn 

fetoxmll 


fetoxmlx f/n, fn 

fetoxmls 


fetoxmly ea, fn 

fetoxmlp 



fetoxmlw 



fetoxmld 



fetoxmlb 



fgetexpx 

get exponent 

fgetexpx ea,fn 

fgetexpl 


fgetexpx f/n, fn 

fgetexps 


fgetexpy ea, fn 

fgetexpp 



fgetexpw 



fgetexpd 



fgetexpb 



fgetmanx 

get mantissa 

fgetmanx ea, fn 

fgetmanl 


fgetmanx f/n, fn 

fgetmans 


fgetmany ea, fn 

fgetmanp 



fgetmanw 



fgetmand 



fgetmanb 



fintx 

integer part 

fintx ea, fn 

fintl 


fintx f/n, fn 

fints 


finty ea, fn 

fintp 



f intw 



fintd 



f intb 



fintrx 

integer part, round toward 0 

fintrx ea,fn 

fintrzl 


fintrx f/n, fn 

fintrzs 


fintry ea, fn 

fintrzp 



fintrzw 



fintrzd 



fintrzb 
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Table B-2 

MC68881 Instructions supported by as— Continued 


Mnemonic 

Operation Name 

Syntax 

fjcc 

jump on condition 

fjcc label 

f jeq 

(equal) 


f jne 

(not equal) 


f jneq 

(not equal or equal) 


f jgt 

(greater than) 


f jngt 

(not greater than) 


f jge 

(greater or equal) 


f jnge 

(not greater or equal) 


f jit 

(less than) 


f jnlt 

(not less than) 


f jle 

(less or equal) 


f jnle 

(not less or equal) 


f jgl 

(greater or less) 


f jngl 

(not greater or less) 


f jgle 

(greater, less or equal) 


fjngle 

(not greater, less or equal) ^ 


f jogt 

(ordered greater than) 


f jule 

(imordered less or equal) 


fjoge 

(ordered greater or equal) 


fjult 

(unordered less than) 


f jolt 

(ordered less dian) 


f juge 

(unordered greater or equal) 


f jole 

(ordered less or equal) 


f jugt 

(unordered greater than) 


f jogl 

(ordered greater or less) 


f jueq 

(unordered equal) 


f jor 

(ordered) 


f jun 

(imordered) 


fjf 

(false) 


f jt 

(true) 


f jsf 

(signalling false) 


f j St 

(signalling true) 


f j seq 

(signalling equal) 


f jsne 

(signalling not equal) 


floglOx 

logio 

floglOx ea,fn 

floglOl 


floglOx fm,fn 

floglOs 


floglOy fn 

floglOp 



floglOw 



floglOd 



flog10b 



flog2x 

log2 

flog2x ea, fn 

flog21 


flog2x fm,fn 

flog2s 


flog2y ea, fn 

flog2p 
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Table B-2 

MC68881 Instructions supported by as — Continued 


Mnemonic 

Operation Name 

Syntax 

flog2w 

log2(contd.) 


flog2d 



flog2b 



flognx 

loge 

flognx ea,fn 

flognl 


flognx fm,fn 

flogns 


flogny ea, fn 

flognp 



flognw 



flognd 



flognb 



flognplx 

loge(x+l) 

flognplx ea,fn 

flognpll 


flognplx fm, fn 

flognpls 


flognply ea, fn 

flognplp 



flognplw 



flognpld 



flognplb 



fmodx 

modulo 

fmodx ea, fn 

fmodl 


fmodx fm, fn 

fmods 


fmody ea,fn 

ftnodp 



fmodw 



fmodd 



fmodb 



fmovex 

move fp register 

fmovex ea,fn 

fmovel 


fmovex fm,ea 

fmoves 


fmovey ea, fn 

fmovep 



fmovew 



fmoved 



fmoveb 



fmovecrx 

move constant ROM 

fmovecrx #ccc, fn 

fmovemx 

move multiple data registers 

fmovemy ea, list 

fmoveml 


fmovemx list, ea 

fmovem 


fmoveml ea, dn 



fmovem dn, ea 

fmulx 

multiply 

fmulx ea, fn 

fmull 


fmulx fm,fn 

fmuls 


fmuly ea,fn 

fmulp 
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Table B-2 

MC68881 Instructions supported by as — Continued 


Mnemonic 

Operation Name 

Syntax 

fmulw 

multiply (contd.) 


fiimld 



fmulb 



fnegx 

negate 

fnegx ea, fn 

fnegl 


fnegx tm,tn 

fnegs 


fnegy ea, fn 

fnegp 



fnegw 



fnegd 



fnegb 



fnop 

no operation 

fnop 

fremx 

IEEE remainder 

fremx ea, fn 

freml 


fremx fm,fn 

frems 


fremy ea,fn 

fremp 



fremw 



fremd 



fremb 



frestore 

restore internal state 

frestore ea 

fsave 

save internal state 

fsave ea 

fscalex 

scale exponent 

fscalex ea,fn 

fscalel 


fscalex fm,fn 

fscales 


fscaley ea, fn 

fscalep 



fscalew 



fscaled 



fscaleb 



f see 

set according to condition 

fscc ea 

f seq 

(equal) 


f sne 

(not equal) 


fsneq 

(not equal or equal) 


f sgt 

(greater than) 


f sngt 

(not greater than) 


f sge 

(greater or equal) 


f snge 

(not greater or equal) 


f sit 

(less than) 


f snlt 

(not less than) 


f sle 

(less or equal) 


f snle 

(not less or equal) 


f sgl 

(greater or less) 


f sngl 

(not greater or less) 


f sgle 

(greater, less or equal) 
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Table B-2 MC68881 Instructions supported by a s— Continued 


Mnemonic 

Operation Name 

Syntax 

fsngle 

(greater, less or equal) 


f sogt 

(not greater, less or equal) 


fsule 

(imordered less or equal) 


f soge 

(ordered greater or equal) 


f suit 

(unordered less than) 


fsolt 

(ordered less than) 


f suge 

(unordered greater or equal) 


f sole 

(ordered less or equal) 


f sugt 

(imordered greater than) 


f sogl 

(ordered greater or less) 


f sueq 

(unordered equal) 


f sor 

(ordered) 


fsun 

(unordered) 


f sf 

(false) 


f St 

(true) 


f ssf 

(signalling false) 


f sst 

(signalling true) 


f sseq 

(signalling equal) 


f ssne 

(signalling not equal) 


fsgldivx 

single-precision divide 

fsgldivx ea,fn 

fsgldivs 


fsgldivx fm,fn 

fsgldivl 


fsgldivy ea,tn 

fsgldivp 



fsgldivw 



fsgldivb 



fsglmulx 

single-precision multiply 

fsglmulx ea, fn 

fsglmuls 


fsglmulx fm,fn 

fsglmull 


fsglmuly ea,fn 

fsglmulp 



fsglmulw 



fsglmulb 



fsinx 

sin 

fsinx ea, fn 

f sinl 


fsinx fm,fn 

fsins 


f siny ea, fn 

f sinp 



f sinw 



f sind 



f sinb 



fsincosx 

simultaneous sine and cosine 

fsincosx ea,fc:fs 

fsincosl 


fsincosx fm,fc-.fs 

fsincoss 


fsincosy ea,fc:fs 

fsincosp 
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Table B-2 MC68881 Instructions supported by as— Continued 


Mnemonic 

Operation Name 

Syntax 

f sincosw 

simultaneous sine and cosine (contd.) 


fsincosd 



fsincosb 



fsinhx 

h 5 fperbolic sine 

fsinhx ea,fn 

fsinhs 


fsinhx fm,fn 

fsinhp 


fsinhy ea, fn 

fsinhw 



fsinhd 



fsinhb 



fsqrtx 

square root 

fsqrtx ea,fn 

fsqrtl 


fsqrtx fm,fn 

fsqrts 


f sqrty ea, fn 

fsqrtp 



fsqrtw 



fsqrtd 



fsqrtb 



fsubx 

subtract 

fsubx ea, fn 

f subl 


fsubx fm,fn 

f subs 


fsuby ea, fn 

fsubp 



f subw 



fsubd 



f subb 



ftanx 

tangent 

ftanx ea, fn 

ftanl 


ftanx ffft, fn 

ftans 


ft any ea, fn 

ftanp 



ftanw 



ftand 



ft anb 



ftanhx 

hyperbolic tangent 

ftanhx ea,fn 

ftanhl 


ftanhx fm,fn 

ftanhs 


ftanhy ea, fn 

ftanhp 



ftanhw 



ftanhd 



ftanhb 



ftentoxx 

10* 

ftentoxx ea,fn 

ftentoxl 


ftentoxx fm,fn 

ftentoxs 


ftentoxy ea,fn 

ftentoxp 
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Mnemonic 


Table B-2 MC68881 Instructions supported by as— Continued 


Operation Name 


Syntax 


ftentoxw 

ftentoxd 

ftentoxb 

10^ (contd.) 


ftrapcc 

trap conditionally 

ft rapcc 

ftrapeq 

ftrapeqw 

ftrapeql 

(equal) 

ftrapcc tidata 

ftrapne 

ftrapnew 

ftrapnel 

(not equal) 


ftrapgt 

ftrapgtw 

ftrapgtl 

(greater than) 


ftrapngt 

(not greatM than) 


ftrapngtw 
ftrapngt1 



ftrapge 

ftrapgew 

ftrapgel 

(greater or equal) 


ftrapnge 

ftrapngew 

ftrapngel 

(not greater or equal) 


ftraplt 

ftrapltw 
ftrapltl 

(less than) 


ftrapnlt 

ftrapnltw 

ftrapnltl 

(not less than) 


ftraple 
ftraplew 
ftraplel 

(less than or equal) 


ftrapnle 

ftrapnlew 

ftrapnlel 

(not less than or equal) 


ftrapgl 

ftrapglw 

ftrapgll 

(greater than or less) 


ftrapngl 

ftrapnglw 

ftrapngll 

(not greater than or less) 


ftrapgle 

ftrapglew 

ftrapglel 

(greater, less or equal) 
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Table B-2 MC68881 Instructions supported by a s— Continued 


Mnemonic Operation Name Syntax 


ftrapngle 

(not greater, less or equal) 

ftrapnglew 


ftrapnglel 


ftrapogt 

(ordered greater than) 

ftrapogtw 


ftrapogtl 


ftrapule 

(unordered less or equal) 

ftrapulew 


ftrapulel 


ftrapoge 

(ordered greater or equal) 

ftrapogew 


ftrapogel 


ftrapult 

(unordered less than) 

ftrapultw 


ftrapultl 


ftrapolt 

(ordered less than) 

ftrapoltw 


ftrapoltl 


ftrapuge 

(unordered greater or equal) 

ftrapugew 


ftrapugel 


ftrapole 

(ordered less or equal) 

ftrapolew 


ftrapolel 


ftrapugt 

(unordered greater than) 

ftrapugtw 


ftrapugtl 


ftrapogl 

(ordered greater or less) 

ftrapoglw 


ftrapogll 


ftrapueq 

(unordered equal) 

ftrapueqw 


ftrapueql 


ftrapor 

(ordered) 

fftraporw 


ftraporl 


trapun 

(unordered) 

ftrapunw 


ftrapunl 


ftrapf 

(false) 

ftrapfw 


ftrapf1 


ftrapt 

(true) 

ftraptw 


ftrapt1 
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Table B-2 MC68881 Instructions supported by a s— Continued 


Mnemonic 

Operation Name 

Syntax 

ftrapsf 
ftraptw 

ftrapsfl 

(signalling false) 


ftrapst 
ftrapsfw 

ftrapstl 

(signalling true) 


ftrapseq 
ftrapseqw 

(signalling equal) 


ftrapseql 

c 


ftrapsne 

ftrapsnew 

(signalling not equal) 


ftrapsnel 



ftstx 

test operand 

ftstx ea 

ftstl 


ftstx fm 

ftsts 

ftstp 

ftstw 

ftstd 

ftstb 


ft sty ea 

ftwotoxx 

2^^ 

ftwotoxx ea, tn 

ftwotoxl 


ftwotoxx tm, in 

ftwotoxs 

ftwotoxp 

ftwotoxw 

ftwotoxd 

ftwotoxb 


ftwotoxy ea, tn 


♦l 


iysl 
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FPA Assembler Syntax 


This appendix describes the Sun Floating-Point Accelerator (FPA) support exten¬ 
sions teas included in Sun software release 3.1 and later. 

The extensions to as are described in general, with discussions of two-, three-, 
and four-operand instruction examples. Some instructions covered separately 
don’t follow the formats described at the beginning of the appendix. The appen¬ 
dix includes restrictions and potential errors, followed by a summary of sup¬ 
ported floating-point instructions. 

C.l. Instruction Syntax The general format for floating-point instructions is 



where 


f p indicates an FPA instmction. 
op is the opcode name. 

t is the operand type, either single (s) or double (d). 

The @A part of the instruction is optional. When present, A specifies the address 
register which contains the base address for the FPA and can be in the range 0..7. 
If this form is used, a previous instruction must load the FPA address 
(OxeOOOOOOO) into the specified address register. 

If @A is not present, then absolute long addressing is used to refer to the FPA. 
This form is more efficient for short routines. 

Depending on the instmction, there may be from zero to four operands specified. 
The operands can be any of the following forms: 

□ Any MC68020 effective address, with the exception that absolute short 
addresses are not allowed for double-precision values. 


□ If either of the data register or the address register is used to hold a double¬ 
precision value, then die value wiU be in a register pair and both registers, 
separated by a colon, must be specified in the instmction. For example: 
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The only exception to this rule is the fplt od instruction (convert integer to 
double-precision value). 

□ In some instructions (command register type) it is possible to specify that the 
register be in constant RAM. The syntax used for this case is %n, where n is 
a register number in the range 0 to 511. 

C.2. Register Syntax The 32 floating-point data registers are designated fpaO, fpal, 

fpa31. The supported control registers are: 


Hardware 

Software 

MODE3_0 

fpamode 

WSTATUS 

fpastatus 


C.3. Operand Types as supports three floating-point operand types: 

o s for single-precision floating-point operands. 

□ d for double-precision floating-point operands. 

o 1 for 32-bit integer operands, used for integer to floating-point conversions. 

C.4. Two-Operand Opcodes such as add, subtract, multiply, divide, negate, absolute value, square 

Instructions root, conversion from integer to floating-point, conversion from single to double 

(and vice versa) are all represented as: 


f 

-\ 

fpopt X, fpan 



J 


where s or d, and X is any valid MC68020 effective address for an operand or 
is an FPA data register. 

If X is an FPA register which is in the constant RAM, then it can be in the range 
0 to 511. If it is not in constant RAM, then it is one of the 32 FPA data registers. 
When Z is an FPA register, then f pan is one of the 32 floating-point data regis¬ 
ters. If X is an effective address, then f pan is one of the FPA registers in the 
range 0 to 15. The following are examples of such instructions: 


f 


\ 


Instruction 

Computes 

fpnegs 

<effective address>, fpal 


fpsqrd 

Keffective address>, fpa2 


fpsubs 

fpal, fpa2 

fpa2 <— lpa2 - fyal 

fprsubs 

fpal, fpa2 

fya2 4- fpal - fya2 

fpdivs 

dO, fpa2 

fpa2 <— fpa2 / dO 

fprdivs 

dO, fpa2 

fya2 4— dO / fpa2 



J 


In the above examples fpr subs and fprdivs are the reverse subtract and 
reverse divide operators, respectively. 
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The opcodes for sine, cosine, atan, e"x, e"x -1, ln(x). 

In (1+x), sqrt (x), and sincos (x) are all supported as command register 
type instructions: 



where t= s or d. 


f pax is either a floating-point register or a register in the constant RAM (which 
is specified as ^number). For the sincos instruction, the destination operand 
is actually a register pair: 



where fpac is the cosine’s destination and f pas is the sine’s destination. 


C.5. Three-Operand The opcodes +, -, *, / are supported in extended and command register forms as 

Instructions 


where t- s or d and X is an <effective address> for an extended instruction or 
a floating-point register for a command register type of instruction. 

In the command register form, X and f paw can indicate a register number in the 
constant RAM. That is, they can either be in the range 0 to 511 or in the range 0 
to 31. In the extended instruction form, f pam and f paw must be in the range 
0 to 15. In the above format the positions of X and f pam can be exchanged for 
the commutative operators add and multiply (the result of the operation remains 
the same). 


For example. 



can be represented by either of the following forms: 


fpaddSs Keffective address>, fpal, fpa2 
fpaddSs fpal, <effective address>, fpa2 


The same rule applies to subtract and divide operations. However, they are not 
commutative, so different answers result from each order. For example. 



must be coded as: 
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whereas 


f —-- 

fpa2 <r- <effective address> - fpal 


must be coded as: 


f 

fpsubSs fpal, <effective address> , fpa2 

N 


V 


Following the same format, 


/-——-- 

fpa3 <— fpa2 - fpal 

V _ 


must be coded as: 

r 


fpsubSs fpal, fpa2, fpa3 


V 

j 


C.6. Four-Operand In the extended and command register formats there are pivot instructions of the 


Instructions 

form: 



f 

fpopt X, fpax, fpay, fpan 

\ 


L 

J 


where f pa« is the destination floating-point data register, t= s or d, and X is 
an effective address or a floating-point register. 

In the extended form, the positions of X and f pa}^ can be exchanged for both 
single- and double-precision types of instmctions. In single-precision extended 
form, it is possible for two of the four operands to be effective addresses. This is 
in general either the first and third or the second and third operands. 

In the command register form, f pax and f pay can be replaced by %x and %y 
indicating register numbers x and y in the constant RAM. 

For four-operand instructions, f pax, f pay and f paw can each be in the range 
0 to 15 when X is an effective address. If Z is an FPA register, then X and f pan' 
must be in the range 0 to 31 and fpax and f pay can either be in the range 0 to 
511 (designating a location in constant RAM) or else in the range 0 to 31. 

These pivot instructions are rather complicated and wUl be dealt with com¬ 
pletely. The following shows the forms of each operation, the assembly code 
equivalent to each form, a generalization of the assembly instruction and a 
sequence of operations equivalent to the pivot instraction. 
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Instruction 

Meaning 

\ 

fpma {s, d} 

<effective address>, reg2, reg3, regl 

regl 4- reg3 + (reg2 * operand) 


fpma{s,d} 

reg2, reg3, <effective address>, regl 

regl 4- operand + (reg3 * reg2) 


fpma{s,d} 

reg4, reg2, reg3, regl 

regl 4- reg3 + (reg2 * reg4) 


fpmas 

<eal>, reg2, <ea2>, regl regl <- operand2 + (reg2 * operandl) 

> 


The fpma instruction, where m stands for multiply, and a stands for add, can 
be generalized as 


. 

N 

fpmaf X, fpar, fpay, fpan 


V 



where tis s or d, and X is an <effective address> or one of the floating-point 
data registers. In the extended type of instruction, the positions of X and f pay 
can be exchanged. Also, for single precision either the first and third operands or 
the second and third operands can be effective addresses. Note that, for example, 

-- - - —, 

fpmas dO, fpal, fpa2, fpa3 

V---- > 


is equivalent to the following sequence of instructions 


f - 



fpmul3s 

dO, fpal, temp 


fpadd3s 

temp, fpa2, temp 


fpmoves 

temp, fpa3 


V_ 


_ } 


where temp is a temporary register. 


fpms{s, d} 
fpms {s,d} 
fpms {s,d} 
fpmss 


Instruction 


Meaning 


<effective address>, reg2, reg3, regl regl <— reg3 - (reg2 * operand) 

reg2, reg3 , <effective address>, regl regl <r- operand - (reg3 * reg2) 

reg4, reg2, reg3, regl regl 4-reg3 - (reg2 * reg4) 

<eal>, reg2, <ea2>, regl regl 4—operand2 - (reg2 * operand 1) 


The f pms instruction, where m stands for multiply, and s stands for subtract, 
can be generalized as 


f 


\ 

fpmsr 

X, fpar, fpay, fpan 






where r is s or d, and X is an <effective address> or one of the floating-point 
data registers. In the extended type of instruction, the positions of X and fpay 
can be exchanged. Also, in single-precision two-memory instructions, either the 
first and third operands or the second and third operands can be effective 
addresses. Note that, for example. 
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is equivalent to the following sequence of instructions 






-N 

fpmulSs 

fpal. 

fpa2, temp 



fpsubSs 

temp. 

dO, temp 



fpmoves 

temp. 

fpa3 







j 



The f pmr instruction, where m stands for multiply, and r stands for reverse 
subtract, can be generalized as 


/ 



fpmrf 

X, fpax, fpay, fpa/i 




J 


where r is s or d, and X is an or one of the floating-point 

data registers. In the extended type of instruction, the positions of X and fpay 
can be exchanged. 


— 

Instruction 

Meaning 


fpmr{s,d} 

Keffecdve address> , reg2, reg3, regl 

regl <r- (-reg3) + (reg2 * operand) 


fpmr{s,d} 

reg2, reg3, <effective address> , regl 

regl <- (-operand) + (reg3 * reg2) 


fpmr{s,d} 

reg4, reg2, reg3, regl 

regl 4- (-reg3) + (reg2 * reg4) 


fpmrs 

V_ 

<eal>, reg2, <ea2>, regl regl «-(-operand2) + (reg2 * operandl) 

j 


In single-precision extended form either the first and third operands or the second 
and third operands can be effective addresses. Note that, for example, 



r 


fpmrs dO, fpal, fpa2, fpa3 

_ ) 

is equivalent to the following sequence of instructions: 

r 

fpmul3s dO, fpal, temp 

A 

fpsub3s fpa2, temp, temp 

fpmoves temp, fpa3 

J 

The f pam instraction, where a stands for add, and m 
be generalized as 

stands for multiply, can 

f 

fpantf X, fpax, fpay, fpan 


V___ 

J 


where r is s or d, and X is an <ejfective address> or one of the floating-point 
data registers. In the extended type of instruction, the positions of X and fpay 
can be exchanged. 
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Instruction 

Meaning 

\ 

fpam{s,d} 

<ejfective address>, reg2, reg3, regl 

regl <- reg3 * (reg2 + operand) 


fpam{s,d} 

reg2, reg3, <effective address>, regl 

regl <- operand * (reg3 + reg2) 


fpam{s,d} 

reg4, reg2, reg3, regl 

regl <— reg3 * (reg2 + reg4) 


fpams 

<eal>, reg2, <ea2>, regl regl <- operand2 * (reg2 + operandl) 



In single-precision two-memory instructions, either the first and third operands or 
the second and third operands can be effective addresses. Note that, for example. 


f .... . , 

s 

fpams fpal, fpa2, fpa3, fpa4 

_ 

_ * 

is equivalent to the following sequence of instructions: 

fpadd3s fpal, fpa2, temp 

N 

fpmul3s temp, fpa3, temp 

fpmoves temp, fpa4 

j 

The fpsm instmction, where s stands for subtract, and 
can be generalized as 

m stands for multiply. 

f 

fpsmr X, fpax, fpay, fpan 

\ 


J 


where t is s or d, and Z is an effective address or one of the floating-point data 
registers. In the extended type of instruction, the positions of Z and f pay can 
be exchanged. The special cases for single-precision instmctions are that either 
the first and third operands or the second and third operands can be effective 
addresses. 


Instruction 


Meaning 


fpsm{s,d} 
fpsm{s,d} 
fpsm{ s,d} 
fpsmfs,d} 
fpsm{s,d} 
fpsms 
fpsms 


Keffective address> , reg2, reg3, 
reg2, reg3, <effective address>, 
reg4, reg2, reg3, regl 
reg2, <effective address> , reg3, 
reg2, reg4, reg3, regl 
<eal>, reg2, <ea2>, regl 
reg2, <eal>, <ea2>, regl 


regl regl <- reg3 * (reg2 - operand) 

regl regl <— operand * (reg3 - reg2) 

regl <- reg3 * (reg2 - reg4) 
regl regl <- reg3 * (-reg2 + operand) 

regl <- reg3 * (-reg2 + reg4) 
regl <- operand2 * (reg2 - operandl) 

regl <— operand2 * (-reg2 + operandl) 


Note that, for example, 

- -—- 

fpsms dO, fpal, fpa2, fpa3 

V___, 


is equivalent to the following sequence of instructions: 
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— 



fpsubSs 

dO, fpal, temp 


fpmul3s 

temp, fpa2, temp 


fpmoves 

temp, fpa3 


V_ 


J 


C.7. Other Instructions Other special instructions are listed below. In each of them the last operand is 

also the destination, except for tst, cmp and mcmp where fpastatus is 
the implied destination. X is either an effective address or an FPA data register 
and t is either s or d for'aU instmctions except f pmovef, where t can be s, 
d, or 1. 


Table C-1 Other Instructions 


Mnemonic 

Operand 

Operation Name 

fpnop 


nop 

fptstf 

X 

operand compare with zero 

fpcmpf 

X, fpaOT 

register m compare with operand 

fpmcmpr 

X, fpam 

register m compare magnitude with operand 

fpmovef 

fpsm, fpan 

move floating-point registers 

fpmove2r 

fpam, fpa« 

2x2 matrix move 

fpmoveSf 

fpam, fpan 

3x3 matrix move 

fpmove41 

fpam, fpan 

4x4 matrix move 

fpdot2f 

fpax, fpay, fpan 

fpan <- fpar*fpay + 

(fpax+7) * (^ay+i) 

fpdotSf 

fpajc, fpay, fpan 

^an <— f pax*^ay + 

(fpar+y) * (^ay+i) + 

(fpar+2) * (^ay+2) 

fpdot4r 

fpax, fpay, fpan 

^an <— f par*^ay + 

(^ar+7)*(:^ay+i) + (^ax+2)*(fpay+2) + 

(h3ax+J)*(^ay+J) 

fptran2f 

fpam, fpan 

transpose 2x2 matrix 

fptranSf 

fpam, fpan 

transpose 3x3 matrix 

fptran4r 

fpam, fpan 

transpose 4x4 matrix 

fpmove 

fpamode, <ea> 

read mode register 

fpmove 

<ea>, fpamode 

write to mode register 

fpmove 

fpastatus, <ea> 

read status register 

fpmove 

<ea>, fpastatus 

write to status register 

fpmovef 

fpam, <ea> 

read a floating-point data register 

fpmovef 

<ea>, fpan 

write to a floating-point data register 
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In double-precision instructions, when absolute short addressing or a single data 
or address register is used, as reports an invalid operand error. 

For the dot product and matrix move and transpose instructions, when the regis¬ 
ter specified does not fall within the specified range, as reports a register out of 
range error. 

For most instructions where one operand is an effective address, the register 
range is 0 to 15. If aU operands are FPA registers, then the register range is 0 to 
31. For constant RAM registers, the range is 0 to 511. as reports an invalid 
operand error when any of these registers are not within the permitted range. 

In the following table, X is any valid MC68020 effective address (the form 
{xxx} : w is not allowed for double) or FPA register. In some three- or four- 
address instructions the position of the X and one of tiie FPA register can be 
exchanged. This is shown in the fourth column of the following table. 


Table C-2 Floating-Point Instructions 


Instruction 

Operand 

Operation 

Alternative 

fpnegs 

X, fpan 

negate single 


fpnegd 

X, fpan 

negate double 


fpabss 

X, fpan 

absolute value single 


fpabsd 

X, f^an 

absolute value double 


fpltos 

X, fpan 

convert integer to single 


fpltod 

X, fpan 

convert integer to double 


fpstol 

X, fpan 

convert single to integer 


fpdtol 

X, fpan 

convert double to integer 


fpstod 

X, fpan 

convert single to double 


fpdtos 

X, fpan 

convert double to single 


fpsqrs 

X, fpan 

square single 


fpsqrd 

X, fpan 

square double 


fpadds 

X, fpan 

add single 


fpaddSs 

X, fpam, fpan 

add single 

fpam, X, fpan 

fpaddd 

X, fpan 

add double 


fpaddSd 

X, fpam, fpan 

add double 

fpam, X, fpan 

fpsubs 

X, fpan 

subtract single 


fpsubSs 

X, fpam, fpan 

subtract single 

fpam, X, fpan 

fprsubs 

<ea>, fpan 

reverse subtract single 


fpsubd 

X, fpan 

subtract double 


fpsubSd 

X, fpam, fpan 

subtract double 

fpam, X, fpan 

fprsubd 

<ea>, fpan 

reverse subtract double 


fpmuls 

X, fpan 

multiply single 


fpmulSs 

X, fpam, fpan 

multiply single 

fpam, X, fpan 


C.9. Instruction Set 
Summary 


C.8. Restrictions and 
Errors 
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Table C-2 Floating-Point Instructions — Continued 


Instruction 

Operand 

Operation 

fpmuld 

X, fpan 

multiply double 

fpmulSd 

X, fpa»i, fpan 

multiply double 

fpdivs 

X, fpan 

divide single 

fpdivSs 

X, fpant, fpan 

divide single 

fprdivs 

<ea>, fpan 

reverse divide single 

fpdivd 

X, fpan 

divide double 

fpdiv3d 

X, fpajn, fpan 

divide double 

fprdivd 

<ea>, fpan 

reverse divide double 

fpnop 


nop 

f pt St s 

X 

single compare with 0 

fptstd 

X 

double compare with 0 

fpcmps 

X, fpa/n 

single compare 

fpcmpd 

X, fpa/n 

double compare 

fpmcmps 

X, fpa/n 

single magnitude compare 

fpmcmpd 

X, fpa/n 

double magnitude compare 

fpslns 

fpax, fpan 

sine single 

fpsind 

fpax, fpan 

sine double 

fpooss 

fpax, fpan 

cosine single 

fpcosd 

fpajc, fpan 

cosine double 

fpatans 

fpax, fpan 

atan single 

fpatand 

fpax, fpan 

atan double 

fpetoxs 

fpax, fpan 

e'x single 

fpetoxd 

fpax, fpan 

e“x double 

fpetoxmls 

fpax, fpan 

e'x-1 single 

fpetoxmld 

fpax, fpan 

e'x-1 double 

fplogns 

fpax, fpan 

ln(x) single 

fplognd 

fpax, fpan 

ln(x) double 

fplognpls 

fpax, fpan 

ln(l+x) single 

fplognpld 

fpax, fpan 

ln(l+x) double 

fpsincoss 

fpax, fpac: fpas 

^ac 4-cosine(x), fpas 4— sine(x) 

fpsincosd 

fpax, fpac:fpas 

^ac 4—cosine(x), fpas 4— sine(x) 

fpmas 

X, fpax, fpay, fpan 

^an 4— (^ax * X) + fpay 

fpmad 

X, fpax, fpay, fpan 

^an 4— (^ax * X) + fpay 

fpmss 

X, fpax, fpay, fpan 

^an4—fpay - (fpax * x) 
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Table C-2 Floating-Point Instructions — Continued 


Instruction 

Operand 


Operation 


Alternative 

fpm3d 

X, fpax, fpay. 

fpan 

^an<—fpay - (fpax * x) 


fpax, X, fpay, fpan 

fpay, fpax, X, fpan 

fpmrs 

X, fpax, fpay, 

\ 

fpan 

fpan (^ax * x) - fpay 


fpax, X, fpay, fpan 

fpay, fpax, X, fpan 
X, fpax, X, fpan 
fpax, X, X, fpan 

fpmrd 

X, fpax, fpay. 

fpan 

^an <— (^ax * x) - fpay 


fpax, X, fpay, fpan 

fpay, fpax, X, fpan 

fpams 

X, fpax, fpay. 

fpan 

^an <— (fpax + x) * fpay 

- 

fpax, X, fpay, fpan 

fpay, fpax, X, fpan 
X, fpax, X, fpan 
fpax, X, X, fpan 

fpamd 

X, fpax, fpay. 

fpan 

^an <— (^ax + x) * fpay 


fpax, X, fpay, fpan 

fpay, fpax, X, fpan 

fpsms 

X, fpax, fpay. 

fpan 

fpan e- (^ax - x) *,f pay 


fpax, X, fpay, fpan 

fpay, fpax, X, fpan 
X, fpax, X, fpan 
fpax, X, X, fpan 

fpsmd 

X, fpax, fpay. 

fpan 

fpan (^ax - x) * fpay 


fpax, X, fpay, fpan 

fpay, fpax, X, fpan 

fpmoves 

<ea>, fpan 


write to a register, single 



fpmoved 

<ea>, fpan 


write to a register, double 



fpmovel 

<ea>, fpa« 


write to a register, integer 



fpmoves 

fpam, <ea> 


read a register, single 



fpmoved 

fpam, <ea> 


read a register, double 



fpmove2s 

fpam, fpan 


2x2 matrix move, single 



fpmove2d 

fpa/n, fpan 


2x2 matrix move, double 



fpmoveSs 

fpam, fpan 


3x3 matrix move, single 



fpmoveSd 

fpam, fpan 


3x3 matrix move, double 



fpmove4s 

fpa/n, fpan 


4x4 matrix move, single 



fpmove4d 

fpa/n, fpan 


4x4 matrix move, double 



fpdot2s 

fpax, fpay, fpan 

^an<—fpax* fpay + (fpax+i) 

* (fpay+i) 


fpdot2d 

fpax, fpay, fpan 

fpan <—fpax* fpay + (fpax+7) 

* (fpay+i) 


fpdotSs 

fpax, fpay, fpan 

^an <—fpax* fpay + (fpax+7) 

* (fpay+i) + 





(fpax+2) * (ipay+2) 



fpdotSd 

fpax, fpay, fpan 

^an<—fpax* fpay + (fpax+i) 

* (fpay+i) + 





(fpax+2) * (^ay+2) 
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Table C-2 Floating-Point Instructions—Continued 


Instruction 

Operand 

Operation 

Alternative 

fpdot4s 

fpax, fpay, fpan 

Ipan <—fpax*fpay + (fpax+7) * (fpay+7) + 
(^ax+2)*(fpay+2) + (^ax+2)*(^ay+2) 


fpdot4d 

fpax, fpay, fpan 

^an <—fpax*fpay + (fpax+i) * (fpay+i) + 
(^ax+2)*(fpay+2) + (fpax+J)*(^ay+5) 


fptran2s 

fpaw, fpan 

transpose 2x2 matrix, single 


fptran2d 

fpa/n, fpan 

transpose 2x2 matrix, double 


fptranSs 

fpaw, fpan 

transpose 3x3 matrix, single 


fptranSd 

fpa/n, fpan 

transpose 3x3 matrix, double 


fptran4s 

fpa/n, fpan 

transpose 4x4 matrix, single 


fptran4d 

fpa/n, fpan 

transpose 4x4 matrix, double 


fpmove 

fpamode, <ea> 

read the mode register 


fpmove 

<ea>, fpamode 

write on mode register 


fpmove 

fpastatus, <ea> 

read the status register 


fpmove 

<ea>, fpastatus 

write to status register 
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A 

absolute expressions, 18 thru 19 
addressing categories, 46 thru 47 
alterable, 46 
control, 46 
data, 46 
memory, 46 

addressing modes, 42 thru 45 
.align directive, 37 
■ ascii directive, 32 
. asciz directive, 33 
assembler directives, 31 thru 38 
.align, 37 
. ascii, 32 
. asciz, 33 
;bss, 34 
. byte, 33 
. cotrun, 36 
. data, 34 
. even, 37 
. globl, 36 
. Icoinin, 35 
. long, 33 
. proc, 38 
. skip, 35 
.text, 34 
. word, 33 

assembler options, 3 thru 4 
-d2,4 
-h,4 
-j.4 
-k, 3 
-L, 3 

-m68010, 3 
-m68020, 3 
-0,3 
-R, 3 

assignment statements, 26 thru 27 

B 

basic elements, 9 thru 13 
.bss directive, 34 
.byte directive, 33 


c 

character set, 9 
. coitim directive, 36 
comment field, 26 
constants, 11 thru 12 
decimal, 11 
floating-point, 12 
hexadecimal, 11 
numeric, 11 
octal, 11 
string, 12 

D 

-d2 option, 4 
. data directive, 34 
decimal constants, 11 
direct assignment, 26 thru T1 
directives, 31 thru 38 
. align, 37 
. ascii, 32 
.asciz, 33 
.bss, 34 
. byte, 33 
. comm, 36 
. data, 34 
. even, 37 
. globl, 36 
. Icomm, 35 
. long, 33 
.proc, 38 
.skip, 35 
.text, 34 
. word, 33 

E 

Error Codes, 51 
. even directive, 37 
expressions, 17 thru 19 
absolute, 18 thru 19 
external, 18 thru 19 
operators, 17 
relocatable, 18 thru 19 
terms, 18 

external expressions, 18 thru 19 
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F 

floating-point constants, 12 
FPA Assembler Syntax, 83 thru 90 

G 

. globl directive, 36 

H 

-h option, 4 

hexadecimal constants, 11 

I 

identifiers, 9 thru 10 
Instruction Syntax, 83 
Instructions, Two-Operand, 84 

J 

- j option, 4 

K 

-k option, 3 

L 

-L option, 3 
label field, 23 thru 24 
labels, 10 thru 11 
local, 10 
numeric, 10 
scope, 10 

. Icomm directive, 35 
lexical elements, 9 thru 13 
lines, 23 
local labels, 10 
location counter, 12 
. long directive, 33 

M 

-m68010 option, 3 
-m68020 option, 3 

N 

notation, 4 thru 5 
numeric constants, 11 
numeric labels, 10 

o 

-o option, 3 
octal constants, 11 
operand field, 25 thru 26 
Operand Types, 84 
operation code field, 24 thru 25 
options, 3 thru 4 
-k,3 
-d2, 4 
-h,4 
-j.4 
-L,3 

-m68010, 3 
-m68020, 3 
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options, continued 
-o, 3 
-R, 3 

P 

. proc directive, 38 
program layout, 23 thru 27 
pseudo-ops, 31 thru 38 
.align, 37 
. ascii, 32 
. asciz, 33 
-bss, 34 
. byte, 33 
. comm, 36 
.data, 34 
.even, 37 
. globl, 36 
. Icomm, 35 
. long, 33 
. proc, 38 
. skip, 35 
■ text, 34 
. word, 33 

R 

-R option, 3 

register operands, 25 thru 26 
address registers, 42 
data registers, 42 
special registers, 42 
Register Syntax, 84 
relocatable expressions, 18 thru 19 

s 

scope of labels, 10 
. skip directive, 35 
special register operands 
cc, 42 
df c, 42 
fpcr, 42 
fpiar, 42 
fpsr, 42 
pc, 42 
sfc, 42 
sp, 42 
sr,42 
usp, 42 
statements, 23 

comment field, 26 
direct assignment, 26 thru 27 
label field, 23 thru 24 
operand field, 25 thru 26 
operation code field, 24 thru 25 
string constants, 12 

T 

. text directive, 34 
Two-Operand Instructions, 84 
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Usage Errors, 51 

w 

. word directive, 33 
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